Capzy Data API. Scegli la tua fonte.
Trova l'endpoint di un sito supportato, invia i suoi parametri e ricevi JSON. Esplora qui il riferimento, poi esegui ed esamina le richieste nel playground della tua dashboard.
Ricerca su Amazon, a colpo d'occhio
GET /v1/amazon/searchEsempio illustrativo
Trova la fonte che ti serve
Ogni fonte ha i propri endpoint, input obbligatori e struttura della risposta. Apri il suo riferimento per verificarne la copertura prima di creare un'integrazione.
Tutte le fonti (83)
La tua prima richiesta alla Data API
Questo esempio Amazon usa un endpoint GET specifico della fonte. HTTP 200 restituisce i dati della fonte; HTTP 202 restituisce uno stato in sospeso e un jobId. Esamina i job in sospeso nella pagina Esecuzioni della dashboard Data API prima di inviare un'altra richiesta.
Crea una chiave Data API
Apri la dashboard Data API per copiare la tua chiave Data API dedicata. I crediti del piano vengono usati per primi; l'utilizzo aggiuntivo viene addebitato sul saldo condiviso del tuo account Capzy.
Apri Data APIScegli la fonte e l'azione
Usa il riferimento del sito per trovare metodo, percorso e parametri obbligatori. L'esempio di ricerca su Amazon invia query e domain a /v1/amazon/search.
Leggi i parametri della ricerca AmazonEsamina il JSON nel playground
Apri la fonte corrispondente nella tua dashboard, seleziona l'azione, compila gli input ed esegui una richiesta. Controlla il prezzo attuale dell'endpoint prima di eseguire.
Apri il playground della ricerca Amazon
# 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"))Conosci il contratto prima di chiamarlo
L'autenticazione è condivisa tra le fonti della Data API. Metodi, parametri e campi restituiti appartengono a ciascun endpoint.
X-API-KeyObbligatorio · header- Invia la tua chiave Data API dedicata in questo header. Tienila sul server e, in questi esempi, leggila da CAPZY_DATA_API_KEY.
/v1/{source}/{path}Specifico dell'endpoint · percorso- Segui il metodo e il percorso indicati nel riferimento della fonte. Ad esempio, GET /v1/amazon/search accetta query e domain come parametri di query.
X-Credits-UsedHeader della risposta- Controlla i crediti addebitati per la richiesta. I prezzi degli endpoint e gli sconti dei piani sono indicati nella dashboard e nel riferimento della fonte.
X-Next-CursorHeader della risposta · se presente- Alcuni endpoint restituiscono un cursore per la pagina successiva. Usa i parametri di paginazione di ciascun endpoint; non tutte le fonti usano lo stesso modello di paginazione.
Usa i campi effettivi della risposta della fonte
Una risposta HTTP 200 della ricerca Amazon espone organic_results al livello principale. HTTP 202 restituisce invece un envelope di stato con jobId; esaminalo nella pagina Esecuzioni della dashboard. Questa risposta riuscita abbreviata usa dati di prodotto illustrativi.
{
"search_information": {
"query": "wireless earbuds"
},
"organic_results": [
{
"title": "Example wireless earbuds",
"price": "$27.99",
"extracted_price": 27.99,
"asin": "EXAMPLE001"
}
]
}Prezzi
I piani Data API includono una quota mensile di crediti. L'utilizzo extra viene addebitato sul saldo condiviso del tuo account Capzy. Controlla il riferimento della fonte per il prezzo attuale in crediti dell'endpoint.
Caricamento dei prezzi attuali…
Alcune cose da sapere
Dove si apre il playground?
In Dashboard → Data API → Scraper. I link alle fonti aprono il builder di quella fonte. I link agli endpoint preselezionano l'azione corrispondente, così puoi esaminare gli input obbligatori prima di eseguire.
Posso usare la chiave API del solver?
Usa la chiave Data API dedicata mostrata nella dashboard Data API. La Data API ha i propri controlli di piano e crediti inclusi, mentre l'utilizzo extra viene finanziato dal saldo condiviso del tuo account Capzy.
Tutte le fonti restituiscono lo stesso JSON?
No. Ogni endpoint ha una struttura di risposta specifica della fonte. Esamina la risposta documentata e gestisci nella tua applicazione i campi mancanti o facoltativi.
E se un endpoint è in arrivo?
La dashboard contrassegna gli endpoint non verificati o non disponibili per l'esecuzione. Usa le azioni supportate mostrate lì; la sola presenza nel riferimento non garantisce che un endpoint sia pronto.
Trova una fonte. Prova una richiesta reale.
Il playground della dashboard riunisce input, risposta e prezzi attuali.
