Amazon Product Search
Amazon Product Search trasforma una frase di prodotto e l’URL di un marketplace in record pubblici di prodotto normalizzati. Ogni elemento può includere URL di origine, titolo, descrizione, venditore, prezzo, valutazione, numero di recensioni, quantità vendute, media, orario di pubblicazione e orario di raccolta, quando questi valori sono disponibili.
Funzionalità della Amazon Product Search API
- Ricerche limitate a un marketplaceAbbina una query di prodotto non vuota a un dominio Amazon supportato, così il marketplace richiesto è sempre esplicito.
- Volume di risultati controllatoImposta un results_limit intero da 1 a 2.000; il collector si ferma al limite richiesto o quando non ci sono più record di origine disponibili.
- Identità normalizzata del prodottoRicevi campi stabili del prodotto per ID, tipo, URL di origine, titolo, descrizione, orario di pubblicazione e orario di raccolta.
- Contesto commercialeUsa i campi disponibili di venditore, prezzo, valutazione, numero di recensioni, quantità vendute e media, senza dover analizzare strutture di risultato specifiche di ogni marketplace.
Parametri della Amazon Product Search API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Parola chiave o frase di prodotto obbligatoria e non vuota. |
domain | Obbligatorio | Riferimento obbligatorio al marketplace Amazon. L’hostname analizzato deve essere amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp oppure un sottodominio. Sono accettati qualsiasi schema con un hostname e i riferimenti relativi al protocollo. |
results_limit | Facoltativo | Limite di risultati richiesto da 1 a 2.000. Se omesso, il valore predefinito è 100. |
Come usare la Amazon Product Search API
Scegli il marketplace di destinazione e una frase di prodotto concreta, poi invia una richiesta asincrona.
- Imposta una query non vuota, indica l’URL di un dominio Amazon supportato e scegli un results_limit da 1 a 2.000.
- Invia con POST la richiesta a /v1/amazon/product-search e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
- Dopo il successo leggi data.results.items e passa next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/amazon/product-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"wireless earbuds","domain":"https://www.amazon.com","results_limit":3}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della Amazon Product Search API
- Scoperta di prodotti in un marketplace: Trova i prodotti pubblici che corrispondono a una categoria, una caratteristica, un brand o una frase con intento d’acquisto in un marketplace Amazon supportato.
- Confronto delle offerte: Confronta importi, valute, prezzi formattati e identità dei venditori disponibili tra i prodotti restituiti.
- Verifica preliminare della reputazione: Esamina valutazioni, numero di recensioni e quantità vendute disponibili, mantenendo i segnali mancanti come non disponibili.
- Arricchimento del catalogo: Arricchisci i prodotti candidati con titoli, descrizioni, URL di origine, media, venditori e timestamp di raccolta normalizzati.
Consigli degli esperti per la Amazon Product Search API
- Salva la query e il dominio inviati insieme a ogni attività, perché la stessa frase può produrre risultati diversi in marketplace diversi.
- Scegli results_limit in base al volume che ti serve: determina la stima di risultati riservata, mentre la fatturazione finale si regola sui record restituiti.
- Segui next_cursor finché has_more è false quando un’attività riuscita contiene più di una pagina di risultati salvati.
- Tratta i valori mancanti di venditore, prezzo, valutazione, numero di recensioni, quantità vendute o media come non disponibili, non come zero né come identità vuota.
API correlate
Oltre alla Amazon Product Search API, usa queste API quando ti serve un altro tipo di dati pubblici di Amazon.
- Amazon Best Sellers API — Raccoglie i prodotti dagli URL pubblici delle categorie Amazon Best Sellers con venditore, prezzo, reputazione, quantità vendute, media, fonte e data normalizzati.
- Amazon Product Details API — Raccoglie i dettagli dei prodotti da URL Amazon noti con titolo, descrizione, venditore, prezzo, valutazione, numero di recensioni, quantità vendute e media.
- Amazon Reviews API — Raccoglie le recensioni pubbliche dei prodotti dagli URL Amazon supportati con testo, valutazioni, dettagli dell’autore, riferimenti al prodotto, date e media.
- Amazon Seller Info API — Raccoglie dagli URL dei venditori Amazon noti identità pubblica del profilo venditore, descrizione, sito web, valutazione, feedback, località, fonte e data di raccolta.
- Amazon Storefront API — Legge la vetrina di un creator Amazon dal suo URL con profilo, account social collegati, liste di idee con numero di articoli, post curati e prodotti di tendenza con prezzo.