Zoeken
Zoek producten of verwerk een geplakte marktplaatslink.
GET /api/v1/search vereist een bearertoken. Het gebruikt dezelfde zoekbeslissing als de webshop en app, zonder klant- of bezoekgeschiedenis vast te leggen.
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"Queryparameters
| Parameter | Regels |
|---|---|
q | Verplicht; omringende spaties worden verwijderd. Zoekwoorden: 2 tot 120 tekens. Geplakte links: maximaal 2.048 tekens. |
provider | taobao (standaard) of a1688. |
page | Geheel getal vanaf nul, van 0 tot 20; standaard 0. |
Stuur elke parameter eenmaal. Ongeldige of herhaalde parameters geven 400 met het probleem bad-body.
Antwoordtypen
Elk geslaagd antwoord bevat kind en request_id.
kind | Velden en betekenis |
|---|---|
products | Zoekresultaten: items, page, pageSize, totalCount, maximumPageCount en unread (een hostobject bij een onleesbare geplakte link, anders null). |
product | Eén product: handle en webshop-url. Een geplakte link of zoekopdracht op artikel-ID kan rechtstreeks dit type opleveren. |
vendor | Een herkende winkel: vendor. |
sheet | Een herkend Google Sheet: sheetId en gid, dat null kan zijn; geen spreadsheetinhoud. |
unsupported | Een herkende maar niet ondersteunde link: link met marketplace en id. |
Elk item in products bevat handle, webshop-url, title, price: { amount, currency: "CNY" }, image (kan null zijn) en marketplace (taobao of a1688). amount is een decimale tekenreeks in Chinese yuan, gelijk aan het webshopoverzicht. Zoek-URL’s zijn gewone product-URL’s; gebruik Links om links met toeschrijving te maken.
Verbruik en snelheidslimieten
Geplakte links gebruiken de anonieme resolver en kunnen geen betaalde Bright Data Web Unlocker gebruiken. Herkende product-, verkoper-, spreadsheet- en niet ondersteunde links slaan zoeken op zoekwoorden over. Een onleesbare geplakte link kan alsnog een zoekopdracht op zoekwoorden worden en OT-zoekquotum verbruiken.
Zoekopdrachten op zoekwoorden hebben een eigen limiet van 30 aanroepen per account per 60 seconden, los van links aanmaken. Geslaagde antwoorden na de toelatingscontrole voor zoekwoorden en weigeringen wegens de zoeklimiet bevatten:
RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60Een weigering geeft 429, het probleem search-rate-limited en Retry-After in seconden. Herkende links verbruiken geen van beide quota en bevatten geen zoeksnelheidsheaders. Elk antwoord bevat X-Request-Id en Cache-Control: no-store. Zie Snelheidslimieten voor de headervelden.