Wyszukiwanie
Wyszukuj produkty lub rozpoznawaj wklejone linki z platform handlowych.
GET /api/v1/search wymaga tokenu bearer. Korzysta z tej samej logiki wyszukiwania co sklep i aplikacja, bez zapisywania historii klienta ani wizyt.
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"Parametry zapytania
| Parametr | Zasady |
|---|---|
q | Wymagany; spacje na początku i końcu są usuwane. Słowa kluczowe: od 2 do 120 znaków. Wklejone linki: do 2048 znaków. |
provider | taobao (domyślnie) lub a1688. |
page | Liczba całkowita od 0 do 20, numeracja od zera; domyślnie 0. |
Każdy parametr podaj raz. Nieprawidłowe lub powtórzone parametry zwracają 400 z problemem bad-body.
Rodzaje odpowiedzi
Każda poprawna odpowiedź zawiera kind i request_id.
kind | Pola i znaczenie |
|---|---|
products | Wyniki wyszukiwania: items, page, pageSize, totalCount, maximumPageCount i unread (obiekt hosta dla nieodczytanego linku, w przeciwnym razie null). |
product | Jeden produkt: handle i sklepowy url. Wklejony link lub wyszukiwanie po identyfikatorze produktu może bezpośrednio zwrócić ten rodzaj. |
vendor | Rozpoznany sklep: vendor. |
sheet | Rozpoznany Arkusz Google: sheetId i gid, który może mieć wartość null; bez zawartości arkusza. |
unsupported | Rozpoznany, nieobsługiwany link: link zawierający marketplace i id. |
Każdy element products zawiera handle, sklepowy url, title, price: { amount, currency: "CNY" }, image (może być null) i marketplace (taobao lub a1688). amount jest dziesiętnym ciągiem znaków w juanach chińskich, zgodnym z siatką produktów w sklepie. Adresy wyników są zwykłymi adresami produktów; do tworzenia linków z przypisaniem użyj Linków.
Zużycie i limity wywołań
Wklejone linki korzystają z anonimowego mechanizmu rozpoznawania i nie mogą uruchamiać płatnego Bright Data Web Unlocker. Rozpoznane linki do produktów, sprzedawców, arkuszy oraz linki nieobsługiwane pomijają wyszukiwanie słów kluczowych. Nieodczytany link może przejść do wyszukiwania słów kluczowych i zużyć limit wyszukiwania OT.
Wyszukiwanie słów kluczowych ma osobny limit 30 wywołań na konto w ciągu 60 sekund, niezależny od tworzenia linków. Poprawne odpowiedzi po kontroli dopuszczenia do wyszukiwania słów kluczowych oraz odmowy z powodu limitu zawierają:
RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60Odmowa zwraca 429, problem search-rate-limited i Retry-After w sekundach. Rozpoznane linki nie zużywają żadnego z obu limitów i nie zawierają nagłówków limitu wyszukiwania. Każda odpowiedź zawiera X-Request-Id i Cache-Control: no-store. Pola nagłówków opisano w Limitach wywołań.