API eBay Recensioni

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint eBay Recensioni di EveryInfra (ebay/reviews).

Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su ebay e action su reviews, e inserisci i parametri in params.
- Parametri obbligatori:
  - seller: Lo username esatto dell'account venditore eBay, non il titolo visualizzato del negozio né il nome dell'azienda.
  - item_id: L'identificatore numerico dell'articolo eBay associato all'inserzione di un venditore (di solito estratto dagli URL /itm/), usato insieme a seller nelle query reviews.
- Parametri facoltativi:
  - country: Input di compatibilità per domain che accetta anch'esso un dominio di un sito eBay come ebay.com, non un codice paese come US o DE. Se sono presenti entrambi, domain ha la precedenza.
  - domain: Seleziona il dominio del sito eBay, ad esempio ebay.com, ebay.de o ebay.co.uk, senza schema né percorso. Il valore predefinito è ebay.com e viene usato per costruire le pagine di search, store e reviews.
  - product_id: Alias di compatibilità per item_id che accetta l'identificatore numerico dell'articolo eBay. Le azioni reviews richiedono comunque item_id.
  - q: Alias di compatibilità per item_id che accetta l'identificatore numerico dell'articolo eBay nelle azioni reviews. Non funziona come query di ricerca a testo libero; per le ricerche di prodotti usa keyword.
  - seller_name: Lo username dell'account venditore eBay.
  - url: Sostituisce la costruzione automatica dell'URL con una pagina diretta delle inserzioni del negozio/venditore eBay nelle azioni store o con una pagina di feedback /fdbk/ nelle azioni reviews.
  - username: Alias di compatibilità per lo username dell'account seller nelle azioni store e reviews. Il parametro seller ha la precedenza e resta obbligatorio.
  - limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 20)
- Restituisce un elenco di record. Campi principali di ogni record: text, rating, rating_scale, username, submitted_at, seller_reply, image_count, reviewer_feedback_score, reviewer_feedback_star, product_name, product_id (ID prodotto del catalogo eBay (product_…), product_price; 14 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=ebay.
- Esempio di corpo della richiesta:
{
  "platform": "ebay",
  "action": "reviews",
  "params": {
    "seller": "musicmagpie",
    "item_id": "388071794887"
  }
}
- Prezzo: $1.39 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.

Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.