amazon/
product-search

Cerca in un marketplace Amazon supportato con una frase di prodotto e ricevi campi normalizzati su prodotto, venditore, prezzo, valutazione, recensioni, quantità vendute e media.

Amazon Product Search API

Ricerca di prodotti
Ambito del marketplace
Record normalizzati
0,15 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
queryObbligatorioParola chiave o frase di prodotto obbligatoria e non vuota.
domainObbligatorioRiferimento 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_limitFacoltativoLimite 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.

  1. Imposta una query non vuota, indica l’URL di un dominio Amazon supportato e scegli un results_limit da 1 a 2.000.
  2. Invia con POST la richiesta a /v1/amazon/product-search e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
  4. 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 true

Casi 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.

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.

Esplora altre piattaforme

Combina i dati di Amazon con i dati pubblici delle altre piattaforme social supportate.

Amazon Product Search API — FAQ

Amazon Product Search API cerca in un marketplace Amazon supportato con una query di prodotto e restituisce record pubblici di prodotto normalizzati tramite un flusso di lavoro basato su attività asincrone.

Il runtime controlla l’hostname analizzato e accetta amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in e amazon.co.jp, sottodomini inclusi. Sono accettati qualsiasi schema con un hostname e i riferimenti relativi al protocollo.

query e domain sono stringhe obbligatorie e non vuote. results_limit è facoltativo, ha 100 come valore predefinito e deve essere un intero da 1 a 2.000.

Un prodotto può contenere ID, piattaforma, risorsa, tipo, URL di origine, orari di pubblicazione e di raccolta, titolo, descrizione, venditore, prezzo, valutazione, numero di recensioni, quantità vendute e media. I campi nullable sono presenti solo quando la fonte fornisce valori utilizzabili.

results_limit è un massimo. La raccolta può concludersi prima quando la fonte pubblica non ha più record corrispondenti, quindi un’attività riuscita può contenere meno prodotti o nessun prodotto.

Interroga /v1/tasks/{task_id}, leggi data.results.items dopo il successo e richiedi la pagina successiva dei risultati dell’attività con next_cursor finché has_more è true.

Ogni prodotto normalizzato restituito correttamente costa 0,15 crediti SocQ. La richiesta riserva i crediti in base a results_limit, o a 100 se omesso, poi regola il conto sul numero effettivo di risultati e rimborsa il credito non usato; un risultato vuoto non comporta alcun addebito.