Suche
Suche Produkte oder löse einen eingefügten Marktplatzlink auf.
GET /api/v1/search erfordert ein Bearer-Token. Der Endpunkt verwendet dieselbe Suchentscheidung wie Storefront und App, ohne Kunden- oder Besuchsverläufe zu speichern.
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"Abfrageparameter
| Parameter | Regeln |
|---|---|
q | Erforderlich, umgebende Leerzeichen werden entfernt. Suchbegriffe: 2 bis 120 Zeichen. Eingefügte Links: bis zu 2.048 Zeichen. |
provider | taobao (Standard) oder a1688. |
page | Bei null beginnende Ganzzahl von 0 bis 20; Standard 0. |
Sende jeden Parameter einmal. Ungültige oder wiederholte Parameter ergeben 400 mit dem Problem bad-body.
Antwortarten
Jede erfolgreiche Antwort enthält kind und request_id.
kind | Felder und Bedeutung |
|---|---|
products | Suchergebnisse: items, page, pageSize, totalCount, maximumPageCount und unread (ein Host-Objekt für einen unlesbaren eingefügten Link, sonst null). |
product | Ein Produkt: handle und Storefront-url. Ein eingefügter Link oder eine Artikel-ID-Suche kann direkt diese Art ergeben. |
vendor | Ein aufgelöster Shop: vendor. |
sheet | Ein erkanntes Google Sheet: sheetId und optional gid (null möglich); keine Tabelleninhalte. |
unsupported | Ein erkannter, nicht unterstützter Link: link mit marketplace und id. |
Jeder Eintrag in products enthält handle, Storefront-url, title, price: { amount, currency: "CNY" }, image (auch null) und marketplace (taobao oder a1688). amount ist eine dezimale Zeichenfolge in chinesischen Yuan und entspricht dem Storefront-Raster. Such-URLs sind gewöhnliche Produkt-URLs; erstelle zugeordnete Links über Links.
Kosten und Ratenlimits
Eingefügte Links verwenden den anonymen Resolver und können keinen kostenpflichtigen Bright Data Web Unlocker nutzen. Erkannte Produkt-, Anbieter-, Tabellen- und nicht unterstützte Links überspringen die Stichwortsuche. Ein unlesbarer eingefügter Link kann in die Stichwortsuche fallen und OT-Suchkontingent verbrauchen.
Stichwortsuchen haben ein eigenes Limit von 30 Aufrufen pro Konto je 60 Sekunden, getrennt von der Linkerstellung. Erfolgreiche Antworten nach der Zulassungsprüfung zur Stichwortsuche und Ablehnungen wegen des Suchlimits enthalten:
RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60Eine Ablehnung ergibt 429, das Problem search-rate-limited und Retry-After in Sekunden. Aufgelöste Links verbrauchen keines der beiden Kontingente und enthalten keine Suchlimit-Header. Jede Antwort enthält X-Request-Id und Cache-Control: no-store. Die Header-Felder erklärt Ratenlimits.