Recherche
Recherchez des produits ou résolvez un lien de marketplace collé.
GET /api/v1/search nécessite un jeton bearer. Il utilise la même logique de recherche que la boutique et l’application, sans enregistrer l’historique du client ni des visites.
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"Paramètres de requête
| Paramètre | Règles |
|---|---|
q | Obligatoire, espaces aux extrémités supprimés. Mots-clés : de 2 à 120 caractères. Liens collés : jusqu’à 2 048 caractères. |
provider | taobao (par défaut) ou a1688. |
page | Entier de 0 à 20, indexé à partir de zéro ; valeur par défaut : 0. |
Envoyez chaque paramètre une seule fois. Les paramètres invalides ou répétés renvoient 400 avec le problème bad-body.
Types de réponses
Toute réponse réussie comporte kind et request_id.
kind | Champs et signification |
|---|---|
products | Résultats par mots-clés : items, page, pageSize, totalCount, maximumPageCount et unread (un objet contenant l’hôte d’un lien collé non lu, sinon null). |
product | Un produit : handle et url dans la boutique. Un lien collé ou une recherche par identifiant d’article peut directement aboutir à ce type. |
vendor | Une boutique résolue : vendor. |
sheet | Une feuille Google reconnue : sheetId et gid, qui peut être null ; aucun contenu de la feuille. |
unsupported | Un lien reconnu mais non pris en charge : link contenant marketplace et id. |
Chaque élément de products contient handle, url dans la boutique, title, price: { amount, currency: "CNY" }, image (qui peut être null) et marketplace (taobao ou a1688). amount est une chaîne décimale en yuans chinois, comme dans la grille de la boutique. Les URL de recherche sont des URL de produits ordinaires ; utilisez Liens pour créer des liens avec attribution.
Consommation et limites de requêtes
Les liens collés utilisent le résolveur anonyme et ne peuvent pas acheter de déblocage payant Bright Data. Les liens reconnus vers des produits, boutiques, feuilles et sites non pris en charge évitent la recherche par mots-clés. Un lien collé non lu peut aboutir à une recherche par mots-clés et consommer le quota de recherche OT.
Les recherches par mots-clés ont leur propre limite de 30 appels par compte et par période de 60 secondes, distincte des appels de création de liens. Les réponses réussies qui atteignent l’admission de la recherche par mots-clés et les refus pour limite de recherche comportent :
RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60Un refus renvoie 429, le problème search-rate-limited et Retry-After en secondes. Les liens collés résolus ne consomment aucune des deux fenêtres et ne comportent pas d’en-têtes de limite de recherche. Toute réponse comporte X-Request-Id et Cache-Control: no-store. Consultez Limites de requêtes pour les champs des en-têtes.