Alibaba Search API

OverviewLink to Overview

The Alibaba Search API queries Alibaba B2B product listings by keyword or search URL. Pass a keyword, a /trade/search URL or a /search/page URL, optionally with subdomain and page, and receive structured JSON with prices, MOQ, seller identity, ratings and pagination.

Search hits the Alibaba open-s JSON API (open-s.alibaba.com) directly. No browser rendering is required. Costs 1 credit per call.

Use each result listing_url or product_id with Alibaba Product for localized PDP data, quantity tiers and lead times.

QuickstartLink to Quickstart

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

Via POST:

POST https://api.piloterr.com/v2/alibaba/search
Content-Type: application/json

{"query": "neon", "subdomain": "french", "page": 1, "return_page_source": false}

ParametersLink to Parameters

Input formatsLink to Input formats

When query is a full URL, subdomain is ignored. Invalid subdomain values return 400.

Supported locale subdomainsLink to Supported locale subdomains

Response: each listing (results[])Link to Response: each listing (results[])

Response: paginationLink to Response: pagination

Alibaba workflowLink to Alibaba workflow

1. Alibaba Search to discover listings (this endpoint)
2. Alibaba Product for full PDP JSON from listing_url or product_id

Error codesLink to Error codes

NotesLink to Notes

• rating and review_count are optional and rarely returned on open-s SERP cards.
• sold_count is optional; omit when Alibaba does not expose it on the card.
• price_max may be omitted even when price_text shows a range, or for single-price listings (price_min only).
• min_order and category follow the search locale (1 Peça, Luzes de Néon, …).
• listing_url may point to www.alibaba.com even when searching a locale subdomain.
• The /search/page HTML shell has no SSR listings; Piloterr calls the open-s API instead.
• Titles may contain HTML entities; the parser prefers puretitle when available.
• Costs 1 credit per call (request / crawler mode).

Main use casesLink to Main use cases

• B2B sourcing: discover suppliers and MOQ by keyword across locales
• Price benchmarking: track price_min / price_max ranges by category
• Catalog discovery: harvest product_id and listing_url at scale before PDP enrichment
• Cross-border research: run the same keyword on french, portuguese, german, … subdomains