L'API Alibaba Search interroge les listings produits B2B Alibaba par mot-clé ou URL de recherche. Passez un mot-clé, une URL /trade/search ou /search/page, optionnellement avec subdomain et page, et recevez prix, MOQ, identité vendeur, notes et pagination en JSON.
La recherche appelle directement l'API JSON open-s (open-s.alibaba.com). Pas de rendu navigateur. Coût : 1 crédit par appel.
Utilisez chaque listing_url ou product_id avec Alibaba Product pour la fiche complète, les paliers quantité et les délais.
GET https://api.piloterr.com/v2/alibaba/search?query=neon
GET https://api.piloterr.com/v2/alibaba/search?query=neon&subdomain=french&page=1
GET https://api.piloterr.com/v2/alibaba/search?query=https://portuguese.alibaba.com/search/page?SearchText=neon&pro=true
| Paramètre |
Type |
Requis |
Description |
query |
string |
oui |
Mot-clé ou URL de recherche Alibaba |
subdomain |
string |
non |
Locale pour recherches par mot-clé (french, portuguese, www, …) |
page |
integer |
non |
Numéro de page à partir de 1 (défaut : 1, 20 résultats/page) |
return_page_source |
boolean |
non |
JSON open-s brut en {"result": "..."} (défaut : false) |
| Format |
Exemple |
Locale |
| Mot-clé |
neon |
www (anglais) sauf si subdomain est défini |
| Mot-clé + subdomain |
query=neon, subdomain=french |
Recherche FR (language=fr) |
| URL trade search |
https://www.alibaba.com/trade/search?SearchText=neon |
Depuis l'hôte de l'URL |
| URL search page |
https://portuguese.alibaba.com/search/page?SearchText=neon&pro=true |
Depuis l'hôte de l'URL |
URL complète : subdomain ignoré. Sous-domaine invalide : 400.
| Subdomain |
Host |
Search API language |
www |
www.alibaba.com |
English (default) |
portuguese |
portuguese.alibaba.com |
pt |
french |
french.alibaba.com |
fr |
spanish |
spanish.alibaba.com |
es |
german |
german.alibaba.com |
de |
italian |
italian.alibaba.com |
it |
russian |
russian.alibaba.com |
ru |
japanese |
japanese.alibaba.com |
ja |
korean |
korean.alibaba.com |
ko |
arabic |
arabic.alibaba.com |
ar |
turkish |
turkish.alibaba.com |
tr |
thai |
thai.alibaba.com |
th |
vietnamese |
vietnamese.alibaba.com |
vi |
indonesian |
indonesian.alibaba.com |
id |
dutch |
dutch.alibaba.com |
nl |
polish |
polish.alibaba.com |
pl |
hindi |
hindi.alibaba.com |
hi |
| Champ |
Type |
Description |
product_id |
string |
ID produit Alibaba |
title |
string |
Titre (HTML nettoyé, puretitle prioritaire) |
listing_url |
string |
URL fiche produit |
image_url |
string |
Miniature principale |
price_text |
string |
Fourchette affichée |
price_min / price_max |
number |
Bornes numériques |
min_order |
string |
MOQ (1 piece, 10 meters, …) |
category |
string |
Catégorie feuille |
seller_name / seller_id |
string |
Nom et ID fournisseur |
rating / review_count / sold_count |
number |
Note, avis, ventes si affichés |
| Champ |
Type |
Description |
page |
integer |
Page courante |
per_page |
integer |
Taille de page (20) |
total_results |
integer |
Total estimé |
total_pages |
integer |
Nombre de pages |
next |
boolean |
Page suivante disponible |
- Alibaba Search pour découvrir les listings (cet endpoint)
- Alibaba Product pour la fiche complète
| Code |
Signification |
400 |
query ou subdomain invalide |
404 |
Résultats non parsables |
500 |
Erreur upstream ou parsing |
- La page
/search/page n'a pas de listings SSR : Piloterr appelle l'API open-s.
- Coût : 1 crédit par appel (mode request / crawler).
- Sourcing B2B : trouver fournisseurs et MOQ par mot-clé et locale
- Benchmark prix : suivre
price_min / price_max par catégorie
- Découverte catalogue : collecter
product_id avant enrichissement PDP
