Langsung ke konten

Capzy Data API. Pilih sumber Anda.

Temukan endpoint situs yang didukung, kirim parameternya, dan terima JSON. Jelajahi referensinya di sini, lalu jalankan dan periksa permintaan di playground dasbor Anda.

Pencarian Amazon, sekilas

Sumber + aksiGET /v1/amazon/search
Querywireless earbuds
Field responsorganic_results · judul, harga, ASIN

Contoh ilustrasi

Temukan sumber yang Anda butuhkan

Setiap sumber memiliki endpoint, input wajib, dan bentuk respons sendiri. Buka referensinya untuk memeriksa cakupan sebelum membangun integrasi.

Semua sumber (83)

Permintaan Data API pertama Anda

Contoh Amazon ini menggunakan endpoint GET khusus sumber. HTTP 200 mengembalikan data sumber; HTTP 202 mengembalikan status tertunda dan jobId. Periksa job yang tertunda di halaman Run dasbor Data API sebelum mengirim permintaan lain.

  1. Buat key Data API

    Buka dasbor Data API untuk menyalin key Data API khusus Anda. Kredit paket digunakan terlebih dahulu; penggunaan tambahan ditagihkan ke saldo akun Capzy bersama Anda.

    Buka Data API
  2. Pilih sumber dan aksi

    Gunakan referensi situs untuk menemukan metode, path, dan parameter wajib. Contoh pencarian Amazon mengirim query dan domain ke /v1/amazon/search.

    Baca parameter pencarian Amazon
  3. Periksa JSON di playground

    Buka sumber yang sesuai di dasbor Anda, pilih aksi, isi input-nya, dan jalankan permintaan. Periksa harga endpoint terkini sebelum menjalankan.

    Buka playground pencarian Amazon
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"))

Pahami kontraknya sebelum memanggil

Autentikasi berlaku sama untuk semua sumber Data API. Metode, parameter, dan field yang dikembalikan adalah milik masing-masing endpoint.

X-API-KeyWajib · header
Kirim key Data API khusus Anda di header ini. Simpan di server dan baca dari CAPZY_DATA_API_KEY dalam contoh-contoh ini.
/v1/{source}/{path}Khusus endpoint · path
Ikuti metode dan path di referensi sumber. Misalnya, GET /v1/amazon/search menerima query dan domain sebagai parameter query.
X-Credits-UsedHeader respons
Periksa kredit yang ditagih untuk permintaan. Harga endpoint dan diskon paket ditampilkan di dasbor dan referensi sumber.
X-Next-CursorHeader respons · jika ada
Beberapa endpoint mengembalikan cursor untuk halaman berikutnya. Gunakan parameter paginasi masing-masing endpoint; tidak semua sumber menggunakan model paginasi yang sama.

Gunakan field respons sebenarnya dari sumber

Respons pencarian Amazon HTTP 200 menampilkan organic_results di level teratas. HTTP 202 sebaliknya mengembalikan envelope status dengan jobId; periksa di halaman Run dasbor. Respons berhasil yang dipersingkat ini menggunakan data produk ilustrasi.

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 · judul, harga, ASIN

Parameter

Harga

Paket Data API mencakup jatah kredit bulanan. Penggunaan tambahan ditagihkan ke saldo akun Capzy bersama Anda. Periksa referensi sumber untuk harga kredit endpoint terkini.

Memuat harga terkini…

Beberapa hal yang perlu diketahui

Di mana playground terbuka?

Di Dasbor → Data API → Scraper. Tautan sumber membuka builder sumber tersebut. Tautan endpoint memilih aksi yang sesuai sebelumnya, sehingga Anda dapat memeriksa input wajib sebelum menjalankan.

Bisakah saya menggunakan API key solver saya?

Gunakan key Data API khusus yang ditampilkan di dasbor Data API. Data API memiliki kontrol paket dan kredit termasuk sendiri, sementara penggunaan tambahan dibiayai oleh saldo akun Capzy bersama Anda.

Apakah setiap sumber mengembalikan JSON yang sama?

Tidak. Setiap endpoint memiliki bentuk respons khusus sumber. Periksa respons yang terdokumentasi dan tangani field yang hilang atau opsional di aplikasi Anda.

Bagaimana jika sebuah endpoint berstatus segera hadir?

Dasbor menandai endpoint yang belum terverifikasi atau belum dapat dijalankan. Gunakan aksi yang didukung yang ditampilkan di sana; entri referensi saja tidak menjamin endpoint sudah siap.

Temukan sumber. Coba permintaan sungguhan.

Playground dasbor menyatukan input, respons, dan harga terkini.

Buka playground