Ricerca
Cerca prodotti o risolvi un link di marketplace incollato.
GET /api/v1/search richiede un token bearer. Usa la stessa logica di ricerca del negozio e dell’app, senza registrare la cronologia del cliente o delle visite.
curl --get https://www.ninjabuy.com/api/v1/search \
-H "Authorization: Bearer $NINJABUY_ACCESS_TOKEN" \
--data-urlencode "q=hoodie" \
--data-urlencode "provider=taobao" \
--data-urlencode "page=0"Parametri di query
| Parametro | Regole |
|---|---|
q | Obbligatorio, con spazi alle estremità rimossi. Parole chiave: da 2 a 120 caratteri. Link incollati: fino a 2.048 caratteri. |
provider | taobao (predefinito) o a1688. |
page | Intero da 0 a 20, con indice a partire da zero; predefinito: 0. |
Invia ogni parametro una sola volta. Parametri non validi o ripetuti restituiscono 400 con il problema bad-body.
Tipi di risposta
Ogni risposta riuscita contiene kind e request_id.
kind | Campi e significato |
|---|---|
products | Risultati per parole chiave: items, page, pageSize, totalCount, maximumPageCount e unread (un oggetto con l’host di un link incollato non letto, altrimenti null). |
product | Un prodotto: handle e url nel negozio. Un link incollato o una ricerca per identificatore articolo può risolversi direttamente in questo tipo. |
vendor | Un negozio risolto: vendor. |
sheet | Un foglio Google riconosciuto: sheetId e gid, che può essere null; nessun contenuto del foglio. |
unsupported | Un link riconosciuto ma non supportato: link contenente marketplace e id. |
Ogni elemento di products contiene handle, url nel negozio, title, price: { amount, currency: "CNY" }, image (che può essere null) e marketplace (taobao o a1688). amount è una stringa decimale in yuan cinesi, come nella griglia del negozio. Le URL di ricerca sono normali URL di prodotto; usa Link per creare link con attribuzione.
Consumo e limiti di richieste
I link incollati usano il risolutore anonimo e non possono acquistare uno sblocco a pagamento Bright Data. I link riconosciuti di prodotti, negozi, fogli e siti non supportati saltano la ricerca per parole chiave. Un link incollato non letto può passare alla ricerca per parole chiave e consumare quota di ricerca OT.
Le ricerche per parole chiave hanno un limite proprio di 30 chiamate per account ogni 60 secondi, separato dalle chiamate di creazione link. Le risposte riuscite che raggiungono l’ammissione della ricerca per parole chiave e i rifiuti per limite di ricerca includono:
RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60Un rifiuto restituisce 429, il problema search-rate-limited e Retry-After in secondi. I link incollati risolti non consumano nessuna finestra e non includono header di limite di ricerca. Ogni risposta include X-Request-Id e Cache-Control: no-store. Consulta Limiti di richieste per i campi degli header.