Documentazione

Primi passi

Dalla registrazione ai primi dati live in pochi minuti. Invii un indirizzo web o un termine di ricerca insieme alla tua chiave API e ricevi i dati in JSON. Poi una breve panoramica su errori, limiti e cache.

Tre passaggi

1
Crea il tuo account
Inserisci la tua e-mail, confermala con il link che ti inviamo e imposta una password. Registrati gratis
2
Copia la tua chiave API
Alla prima visita, la dashboard crea una chiave chiamata “default” e la mostra una sola volta. Copiala e conservala al sicuro.
3
Fai la tua prima richiesta
Premi Provalo nel quickstart della dashboard oppure esegui la richiesta qui sotto con la tua chiave.

La tua chiave API

Invia la tua chiave con ogni richiesta nell'header x-api-key. Le chiavi iniziano con ds_. Salviamo solo un'impronta di ogni chiave, quindi viene mostrata per intero una sola volta, al momento della creazione. Conservala in un secret manager, mai in codice eseguito nel browser. Puoi creare altre chiavi e revocare quelle vecchie in Chiavi API.

x-api-key: ds_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

URL di base: https://api.everydata.io.

La tua prima richiesta

Cerca “wireless headphones” su Amazon. È la stessa richiesta del pulsante Provalo nella dashboard, dove la tua chiave è già inserita subito dopo la creazione. withCache=true consente una risposta vecchia fino a 10 minuti, il che la rende veloce.

GET /amz/amazon-search-by-keyword-asin

curl "https://api.everydata.io/amz/amazon-search-by-keyword-asin?domainCode=com&keyword=wireless+headphones&page=1&withCache=true" \
  -H "x-api-key: YOUR_API_KEY"

Cosa ricevi

Ogni risposta riuscita è un JSON che inizia con gli stessi due campi, responseStatus e responseMessage, seguiti dai dati dell'endpoint. Le pagine di risultati aggiungono currentPage, nextPage e lastPage.

200 OK

{
  "responseStatus": "PRODUCT_FOUND_RESPONSE",
  "responseMessage": "Product successfully found!",
  "domainCode": "com",
  "keyword": "wireless headphones",
  "foundProducts": [
    "…"
  ],
  "searchProductDetails": [
    "…"
  ]
}

Errori

Gli errori restituiscono un piccolo corpo JSON con lo stato HTTP e un messaggio leggibile. Solo le risposte riuscite e i 404 (un “non trovato” valido) vengono conteggiati nella tua quota.

400 Bad Request

{
  "statusCode": 400,
  "statusMessage": "Bad Request - Missing or invalid parameter: keyword: Field required"
}

HTTP	Significato	Conteggiato
200	Successo. I dati seguono responseStatus e responseMessage.	Sì
400	Manca un parametro obbligatorio oppure ha un formato errato.	No
401	La chiave API manca, è errata o è stata revocata.	No
403	La tua quota mensile (o il limite di fair use) è esaurita.	No
404	La pagina è stata caricata, ma non esiste alcun prodotto o annuncio per il tuo input.	Sì
429	Troppe richieste al minuto. Il messaggio indica quanti secondi attendere.	No
502	Il sito ha bloccato questo tentativo. Riprova.	No
503	Non è stato possibile caricare il sito. Riprova.	No

Limiti e quota

Per ogni account valgono due limiti: richieste al minuto (da 10 a 750, a seconda del piano) e richieste al mese. Entrambi sono condivisi da tutte le piattaforme e tutte le chiavi del tuo account. Troppe richieste al minuto restituiscono 429; quando la quota mensile è esaurita ricevi 403 finché non si azzera all'inizio del periodo di fatturazione successivo.

Le richieste che falliscono perché un sito non è stato caricato (5xx) non vengono conteggiate. Il tuo utilizzo attuale è nella pagina di utilizzo; nei prezzi trovi i limiti di ogni piano.

Cache

Le risposte sono live per impostazione predefinita. Dove la velocità conta più dell'aggiornamento, diversi endpoint accettano withCache=true o cacheTtl (secondi) e possono rispondere da una copia recente. Una risposta dalla cache conta comunque come una richiesta.

Prossimo passo: sfoglia la API reference completa.