Piloterr

Alibaba Search

GET
/v2/alibaba/search

Alibaba Search API. Query B2B product listings by keyword or search URL across 17 locale subdomains. Request mode returns prices, MOQ, seller data and pagination.

Credit cost: 1 credit per call

Autorisierung

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Abfrageparameter

query*string

Search keyword or full Alibaba search URL.

Examples (keyword):

neon

Examples (search URL):

https://www.alibaba.com/trade/search?SearchText=neon
https://portuguese.alibaba.com/search/page?SearchText=neon&pro=true

Notes:

  • Keyword alone defaults to www.alibaba.com (English).
  • Use subdomain=french to force a locale on keyword searches.
  • Full URLs keep the host locale; subdomain is ignored.
  • Pass each listing_url or product_id to Alibaba Product.
subdomain?string

Locale subdomain for keyword searches when query is not a full URL.

Examples:

french
portuguese
french.alibaba.com

Ignored when query is a full Alibaba URL. Invalid values return 400.

page?number

1-based page number (20 results per page). Default: 1.

Range1 <= value <= 500
return_page_source?boolean

When true, return the raw open-s JSON as {"result": "..."} instead of structured JSON. Defaults to false.

Antworttext

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/alibaba/search?query=string"
{  "results": [    {      "title": "Mais Vendido: Letreiro Luminoso de LED Personalizado com Logo para Negócios, Lojas, Interiores, Festas e Decoração de Casa – Letreiro Neon de LED em Acrílico Direto da Fábrica",      "category": "Luzes de Néon",      "image_url": "https://s.alicdn.com/@sc04/kf/Hdf89e9011f0f46b18ba7e388551bded5e.png_300x300.png",      "min_order": "1 Peça",      "price_max": 30,      "price_min": 9.9,      "seller_id": "247085343",      "price_text": "US $9.90-$30.00",      "product_id": "1601525671361",      "sold_count": 21,      "listing_url": "https://www.alibaba.com/product-detail/Hot-Selling-Custom-LED-Logo-Light_1601525671361.html?s=p",      "seller_name": "Fujian Puchuang Information Technology Co., Ltd."    },    {      "title": "Letreiros de Neon Personalizados, Luzes LED RGB Dimmáveis para Decoração de Parede, Quarto, Casamento, Aniversário, Bar, Logotipo da Empresa, Nome",      "category": "Luzes de Néon",      "image_url": "https://s.alicdn.com/@sc04/kf/Hc55da60b1b834209928da3bf1f3ee87a2.jpg_300x300.jpg",      "min_order": "1 Peça",      "price_max": 22.5,      "price_min": 18.5,      "seller_id": "242268971",      "price_text": "US $18.50-$22.50",      "product_id": "1600583937291",      "sold_count": 303,      "listing_url": "https://www.alibaba.com/product-detail/Custom-Neon-Signs-Personalized-Dimmable-LED_1600583937291.html?s=p",      "seller_name": "Evermore Enterprise (Zhejiang) Ltd."    },    {      "title": "Neon LED Strip 12V LED Strip Multicolor Neon Light Outdoor LED Strip Lights Decoração de luzes impermeáveis Flex Neon",      "category": "Luzes de Néon",      "image_url": "https://s.alicdn.com/@sc04/kf/H72f8a620855b4f5da867b2248bb8fd1ed.png_300x300.png",      "min_order": "10 Metros",      "price_min": 0.35,      "seller_id": "274667237",      "price_text": "US $0.35",      "product_id": "1601062675641",      "sold_count": 1063,      "listing_url": "https://www.alibaba.com/product-detail/Neon-LED-Strip-12V-LED-Strip_1601062675641.html",      "seller_name": "Shenzhen Chengjie Lighting Co., Ltd."    }  ],  "pagination": {    "next": true,    "page": 1,    "per_page": 20,    "total_pages": 2398,    "total_results": 47955  }}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}