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
GET /v1/amazon/searchIllustratief 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.
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 openenKies 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-zoekopdrachtenBekijk 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
# 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.
{
"search_information": {
"query": "wireless earbuds"
},
"organic_results": [
{
"title": "Example wireless earbuds",
"price": "$27.99",
"extracted_price": 27.99,
"asin": "EXAMPLE001"
}
]
}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.
