İçeriğe geç

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ı

Kaynak + eylemGET /v1/amazon/search
Sorguwireless earbuds
Yanıt alanıorganic_results · başlıklar, fiyatlar, ASIN'ler

Açı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.

  1. 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ç
  2. 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 okuyun
  3. JSON'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ç
amazon_search.py
# 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.

response.example.json
{
  "search_information": {
    "query": "wireless earbuds"
  },
  "organic_results": [
    {
      "title": "Example wireless earbuds",
      "price": "$27.99",
      "extracted_price": 27.99,
      "asin": "EXAMPLE001"
    }
  ]
}

organic_results · başlıklar, fiyatlar, ASIN'ler

Parametreler

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.

Test alanını aç