API Amazon Prodotti concorrenti

Temporaneamente non disponibile

Stiamo ripristinando questa funzionalità. Nel frattempo le chiamate di solito non vanno a buon fine o non restituiscono risultati; le chiamate non riuscite e i risultati vuoti non vengono addebitati.

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore: Temporaneamente non disponibile

Buono / normale
Disponibile
Limitato
Quasi del tutto inattivo

Temporaneamente non disponibile

Ultime 24 ore

Ultimi 30 giorni

Trova i prodotti di Amazon US che competono con un asin sulle stesse keyword di ricerca. Per ogni concorrente trovi quante keyword condivide con il tuo prodotto, la sua posizione media su di esse e quante ne occupa come risultato organico o sponsorizzato, con il relativo volume di ricerca complessivo. 20 concorrenti per impostazione predefinita, fino a 100. Le righe contengono ASIN e link, non titoli o prezzi.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su amazon e action impostato su product_competitors. Prezzo $11.51 per 1.000 richieste ($0.01151 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.

Prompt per l'AI

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Amazon Prodotti concorrenti di EveryInfra (amazon/product_competitors).

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 amazon e action su product_competitors, e inserisci i parametri in params.
- Parametri obbligatori:
  - asin: Un solo ASIN Amazon per ranked_keywords o product_competitors: 10 lettere maiuscole o cifre, ad esempio B0C2JXSHSK. Elenchi e ASIN separati da virgole vengono rifiutati.
- Parametri facoltativi:
  - 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: asin (Amazon Standard Identification Number,…), url, shared_keywords (Numero di parole chiave di ricerca per…), avg_position (La posizione media del concorrente su q…), shared_organic_keywords (Parole chiave condivise per cui il conc…), shared_organic_top10_keywords (Parole chiave condivise per cui il risu…), shared_organic_search_volume (Volume di ricerca mensile complessivo d…), shared_sponsored_keywords (Parole chiave condivise per cui il conc…), shared_sponsored_search_volume (Volume di ricerca mensile complessivo d…), organic_keywords (Tutte le parole chiave per cui il conco…), sponsored_keywords (Tutte le parole chiave per cui il conco…), target_asin (L'ASIN che hai richiesto (product_compe…).
- Esempio di corpo della richiesta:
{
  "platform": "amazon",
  "action": "product_competitors",
  "params": {
    "asin": "B0C2JXSHSK"
  }
}
- Prezzo: $11.51 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.

Parametri della richiesta

Nome	Posizione	Tipo	Obbligatorio	Predefinito	Descrizione
`Authorization`	header	`string`	Sì	-	Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
`platform`	body	`string`	Sì	`amazon`	Identificativo della piattaforma, valore fisso.
`action`	body	`string`	Sì	`product_competitors`	Identificativo della funzionalità, valore fisso.
`asin`	body.params	`string`	Sì	-	Un solo ASIN Amazon per `ranked_keywords` o `product_competitors`: 10 lettere maiuscole o cifre, ad esempio `B0C2JXSHSK`. Elenchi e ASIN separati da virgole vengono rifiutati. È coperto solo il marketplace statunitense (amazon.com), quindi un ASIN di un altro store non restituisce dati.
`limit`	body.params	`integer (1–100)`	No	`20`	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. I valori superiori vengono accettati e limitati al valore massimo.

Esempi di codice

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "amazon",
  "action": "product_competitors",
  "params": {
    "asin": "B0C2JXSHSK"
  }
}'

Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.

Esempio di risposta

json

{  "id": "req_…",  "platform": "amazon",  "action": "product_competitors",  "results": [    {      "asin": …,      "url": …,      "shared_keywords": …,      "avg_position": …,      "shared_organic_keywords": …,      "shared_organic_top10_keywords": …,      "shared_organic_search_volume": …,      "shared_sponsored_keywords": …,      "shared_sponsored_search_volume": …,      "organic_keywords": …,      "sponsored_keywords": …,      "target_asin": …,      "platform": …    }  ],  "count": …,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campi della risposta

I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.

Campo	Significato
`asin`	Amazon Standard Identification Number, l'ID univoco del prodotto all'interno di uno store.
`url`	Link al record sulla piattaforma.
`shared_keywords`	Numero di parole chiave di ricerca per cui si posizionano sia il concorrente sia il prodotto richiesto (product_competitors); le righe sono ordinate in base a questo valore, dal più alto al più basso.
`avg_position`	La posizione media del concorrente su quelle parole chiave condivise (product_competitors); un valore più basso indica una posizione più alta.
`shared_organic_keywords`	Parole chiave condivise per cui il concorrente compare come risultato organico (product_competitors).
`shared_organic_top10_keywords`	Parole chiave condivise per cui il risultato organico del concorrente è nella top 10 (product_competitors).
`shared_organic_search_volume`	Volume di ricerca mensile complessivo delle parole chiave condivise per cui il concorrente compare come risultato organico (product_competitors).
`shared_sponsored_keywords`	Parole chiave condivise per cui il concorrente compare come risultato sponsorizzato (product_competitors).
`shared_sponsored_search_volume`	Volume di ricerca mensile complessivo delle parole chiave condivise per cui il concorrente compare come risultato sponsorizzato (product_competitors).
`organic_keywords`	Tutte le parole chiave per cui il concorrente si posiziona come risultato organico, non solo quelle condivise (product_competitors).
`sponsored_keywords`	Tutte le parole chiave per cui il concorrente si posiziona come risultato sponsorizzato, non solo quelle condivise (product_competitors).
`target_asin`	L'ASIN che hai richiesto (product_competitors), lo stesso su ogni riga.
`platform`	Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

Errori e addebiti

401: Chiave mancante o non valida.
402: Saldo insufficiente. Effettua prima una ricarica.
422: Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
429: Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
503: Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
Risposta 200 vuota: Nessun dato. Nessun addebito.

Errori