Piloterr

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

GET
/v2/alibaba/search

Authorization

ApiKeyAuth
x-api-key<token>

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

In: header

Query Parameters

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.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.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"
}