Naar inhoud springen

Capzy Data API. Kies je bron.

Vind het endpoint van een ondersteunde site, stuur de parameters en ontvang JSON. Verken hier de referentie en voer verzoeken uit en bekijk ze in de playground van je dashboard.

Amazon-zoekopdracht in één oogopslag

Bron + actieGET /v1/amazon/search
Querywireless earbuds
Veld in antwoordorganic_results · titels, prijzen, ASIN's

Illustratief voorbeeld

Vind de bron die je nodig hebt

Elke bron heeft eigen endpoints, verplichte invoer en een eigen vorm van het antwoord. Open de referentie om de dekking te controleren voordat je een integratie bouwt.

Alle bronnen (83)

Je eerste Data API-verzoek

Dit Amazon-voorbeeld gebruikt een bronspecifiek GET-endpoint. HTTP 200 levert brondata op; HTTP 202 levert een status pending en een jobId op. Bekijk openstaande jobs op de pagina Runs in het Data API-dashboard voordat je een nieuw verzoek stuurt.

  1. Maak een Data API-sleutel aan

    Open het Data API-dashboard om je eigen Data API-sleutel te kopiëren. Abonnementscredits worden eerst gebruikt; extra gebruik wordt afgeschreven van je gedeelde Capzy-accountsaldo.

    Data API openen
  2. Kies de bron en actie

    Gebruik de referentie van de site om de methode, het pad en de verplichte parameters te vinden. Het voorbeeld voor Amazon-zoekopdrachten stuurt query en domain naar /v1/amazon/search.

    Lees de parameters voor Amazon-zoekopdrachten
  3. Bekijk de JSON in de playground

    Open de bijbehorende bron in je dashboard, kies de actie, vul de invoer in en voer een verzoek uit. Controleer vooraf de actuele prijs van het endpoint.

    Playground voor Amazon-zoekopdrachten openen
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"))

Ken het contract voordat je het aanroept

Authenticatie is gelijk voor alle Data API-bronnen. Methoden, parameters en teruggegeven velden horen bij elk endpoint afzonderlijk.

X-API-KeyVerplicht · header
Stuur je eigen Data API-sleutel mee in deze header. Houd hem op de server en lees hem in deze voorbeelden uit CAPZY_DATA_API_KEY.
/v1/{source}/{path}Per endpoint · pad
Volg de methode en het pad uit de referentie van de bron. GET /v1/amazon/search neemt bijvoorbeeld query en domain als queryparameters.
X-Credits-UsedAntwoordheader
Bekijk de in rekening gebrachte credits voor het verzoek. Endpointprijzen en abonnementskortingen staan in het dashboard en de bronreferentie.
X-Next-CursorAntwoordheader · indien aanwezig
Sommige endpoints geven een cursor terug voor de volgende pagina. Gebruik de pagineringsparameters van elk endpoint; niet elke bron gebruikt hetzelfde pagineringsmodel.

Gebruik de echte antwoordvelden van de bron

Een HTTP 200-antwoord voor een Amazon-zoekopdracht biedt organic_results op het hoogste niveau. HTTP 202 levert in plaats daarvan een statusenvelope met jobId op; bekijk die op de pagina Runs in het dashboard. Dit ingekorte geslaagde antwoord gebruikt illustratieve productgegevens.

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 · titels, prijzen, ASIN's

Parameters

Prijzen

Data API-abonnementen bevatten een maandelijks credittegoed. Extra gebruik wordt afgeschreven van je gedeelde Capzy-accountsaldo. Controleer de bronreferentie voor de actuele creditprijs van het endpoint.

Actuele prijzen laden…

Goed om te weten

Waar opent de playground?

In Dashboard → Data API → Scrapers. Bronlinks openen de builder van die bron. Endpointlinks selecteren vooraf de bijbehorende actie, zodat je de verplichte invoer kunt bekijken voordat je uitvoert.

Kan ik mijn solver-API-sleutel gebruiken?

Gebruik de eigen Data API-sleutel die in het Data API-dashboard staat. Data API heeft eigen abonnementsinstellingen en inbegrepen credits, terwijl extra gebruik wordt betaald uit je gedeelde Capzy-accountsaldo.

Levert elke bron dezelfde JSON op?

Nee. Elk endpoint heeft een bronspecifieke vorm van het antwoord. Bekijk het gedocumenteerde antwoord en handel ontbrekende of optionele velden af in je applicatie.

Wat als een endpoint binnenkort beschikbaar komt?

Het dashboard markeert endpoints die niet geverifieerd of beschikbaar zijn om uit te voeren. Gebruik de ondersteunde acties die daar staan; een vermelding in de referentie alleen belooft niet dat een endpoint klaar is.

Vind een bron. Probeer een echt verzoek.

De playground in het dashboard brengt de invoer, het antwoord en de actuele prijzen samen.

Playground openen