Capzy Data API. Kaynağınızı seçin.
Desteklenen bir sitenin uç noktasını bulun, parametrelerini gönderin ve JSON alın. Başvuruyu burada inceleyin, ardından istekleri panel test alanınızda çalıştırıp inceleyin.
Bir bakışta Amazon araması
GET /v1/amazon/searchAçıklayıcı örnek
İhtiyacınız olan kaynağı bulun
Her kaynağın kendi uç noktaları, zorunlu girdileri ve yanıt yapısı vardır. Entegrasyon geliştirmeden önce kapsamı kontrol etmek için başvurusunu açın.
Tüm kaynaklar (83)
İlk Data API isteğiniz
Bu Amazon örneği kaynağa özgü bir GET uç noktası kullanır. HTTP 200 kaynak verilerini döndürür; HTTP 202 bekleyen bir durum ve jobId döndürür. Başka bir istek göndermeden önce bekleyen işleri Data API panelindeki Çalıştırmalar sayfasında inceleyin.
Bir Data API anahtarı oluşturun
Size özel Data API anahtarınızı kopyalamak için Data API panelini açın. Önce plan kredileri kullanılır; ek kullanım paylaşılan Capzy hesap bakiyenizden ücretlendirilir.
Data API'yi açKaynağı ve eylemi seçin
Metodu, yolu ve zorunlu parametreleri bulmak için sitenin başvurusunu kullanın. Amazon arama örneği /v1/amazon/search adresine query ve domain gönderir.
Amazon arama parametrelerini okuyunJSON'u test alanında inceleyin
Panelinizde ilgili kaynağı açın, eylemi seçin, girdilerini doldurun ve bir istek çalıştırın. Çalıştırmadan önce güncel uç nokta fiyatını kontrol edin.
Amazon arama test alanını aç
# Install: pip install requests
import os
import requests
response = requests.get(
"https://api.capzy.ai/v1/amazon/search",
headers={"X-API-Key": os.environ["CAPZY_DATA_API_KEY"]},
params={"query": "wireless earbuds", "domain": "com"},
timeout=120,
)
response.raise_for_status()
data = response.json()
if response.status_code == 202:
print("Pending:", data.get("status"), "Job:", data.get("jobId"))
print("Inspect this job in https://capzy.ai/dashboard/data-api/runs")
else:
for item in data.get("organic_results", []):
print(item["title"], item.get("price"))
print("Credits used:", response.headers.get("X-Credits-Used"))Çağırmadan önce sözleşmeyi bilin
Kimlik doğrulama tüm Data API kaynaklarında ortaktır. Metotlar, parametreler ve dönen alanlar her uç noktaya özgüdür.
X-API-KeyZorunlu · başlık- Size özel Data API anahtarınızı bu başlıkta gönderin. Sunucuda tutun ve bu örneklerde CAPZY_DATA_API_KEY değişkeninden okuyun.
/v1/{source}/{path}Uç noktaya özgü · yol- Kaynak başvurusundaki metodu ve yolu izleyin. Örneğin GET /v1/amazon/search, query ve domain değerlerini sorgu parametresi olarak alır.
X-Credits-UsedYanıt başlığı- İstek için ücretlendirilen kredileri inceleyin. Uç nokta fiyatları ve plan indirimleri panelde ve kaynak başvurusunda gösterilir.
X-Next-CursorYanıt başlığı · varsa- Bazı uç noktalar sonraki sayfa için bir cursor döndürür. Her uç noktanın sayfalama parametrelerini kullanın; her kaynak aynı sayfalama modelini kullanmaz.
Kaynağın gerçek yanıt alanlarını kullanın
HTTP 200 Amazon arama yanıtı, organic_results alanını en üst düzeyde sunar. HTTP 202 ise jobId içeren bir durum zarfı döndürür; bunu panelin Çalıştırmalar sayfasında inceleyin. Bu kısaltılmış başarılı yanıt açıklayıcı ürün verileri kullanır.
{
"search_information": {
"query": "wireless earbuds"
},
"organic_results": [
{
"title": "Example wireless earbuds",
"price": "$27.99",
"extracted_price": 27.99,
"asin": "EXAMPLE001"
}
]
}Fiyatlandırma
Data API planları aylık kredi hakkı içerir. Ek kullanım paylaşılan Capzy hesap bakiyenizden ücretlendirilir. Güncel uç nokta kredi fiyatı için kaynak başvurusunu kontrol edin.
Güncel fiyatlar yükleniyor…
Bilmeniz gereken birkaç şey
Test alanı nerede açılır?
Panel → Data API → Kazıyıcılar bölümünde. Kaynak bağlantıları o kaynağın oluşturucusunu açar. Uç nokta bağlantıları ilgili eylemi önceden seçer, böylece çalıştırmadan önce zorunlu girdileri inceleyebilirsiniz.
Çözücü API anahtarımı kullanabilir miyim?
Data API panelinde gösterilen size özel Data API anahtarını kullanın. Data API'nin kendi plan kontrolleri ve dahil kredileri vardır; ek kullanım ise paylaşılan Capzy hesap bakiyenizden karşılanır.
Her kaynak aynı JSON'u mu döndürür?
Hayır. Her uç noktanın kaynağa özgü bir yanıt yapısı vardır. Belgelenmiş yanıtını inceleyin ve eksik veya isteğe bağlı alanları uygulamanızda ele alın.
Bir uç nokta çok yakında olarak işaretliyse ne olur?
Panel, doğrulanmamış veya çalıştırılamayan uç noktaları işaretler. Orada gösterilen desteklenen eylemleri kullanın; yalnızca bir başvuru kaydının bulunması uç noktanın hazır olduğunu garanti etmez.
Bir kaynak bulun. Gerçek bir istek deneyin.
Panel test alanı girdileri, yanıtı ve güncel fiyatlandırmayı bir araya getirir.
