Alibaba Search API

GET   /api/v1/search?engine=alibaba_search

The Alibaba Search API returns Alibaba.com products for a search, 48 per page by default and up to 100. Each product carries its price range with any promotion and discount, the unit price for each order quantity, its minimum order, category, images and certifications, and whether it is an ad, along with its supplier's country, years on Alibaba, Gold, Verified and Verified PRO badges, rating, response rate and audits. Filter by supplier country, Verified or Verified PRO suppliers, Trade Assurance, ready to ship, free samples, minimum order, price or the category_id of a product, get titles and prices in 19 languages and 39 currencies, and page through up to 100 pages.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    Parameter defines the search terms, such as bluetooth speaker or office chair, up to 200 characters.

Localization

  • Name
    language
    Required
    Optional
    Description

    Parameter defines the language of product titles and order units. It can be set to ar, de, en, es, fr, he, hi, id, it, ja, ko, nl, pl, pt, ru, th, tr, vi or zh, and defaults to en. Supplier ratings are only returned in English.

  • Name
    currency
    Required
    Optional
    Description

    Parameter defines the currency of the prices and price tiers, as a three-letter currency code such as USD, EUR, GBP or JPY. It can be set to AED, ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, DKK, EGP, EUR, GBP, HKD, IDR, ILS, INR, JPY, KRW, KZT, MXN, MYR, NGN, NOK, NZD, PHP, PKR, PLN, RUB, SAR, SEK, SGD, THB, TRY, TWD, UAH, USD, VND or ZAR, and defaults to USD.

Filters

  • Name
    category_id
    Required
    Optional
    Description

    Parameter keeps the search within an Alibaba category, given as the category_id of a product, such as 518.

  • Name
    supplier_country
    Required
    Optional
    Description

    Parameter keeps only the products of suppliers based in a country, as an ISO 3166-1 alpha-2 country code such as CN, VN or GB. Each product's supplier.country_code uses the same codes.

  • Name
    is_verified_supplier
    Required
    Optional
    Description

    Parameter keeps only the products of Verified suppliers when set to true.

  • Name
    is_verified_pro_supplier
    Required
    Optional
    Description

    Parameter keeps only the products of Verified PRO suppliers when set to true.

  • Name
    has_trade_assurance
    Required
    Optional
    Description

    Parameter keeps only the products covered by Trade Assurance when set to true.

  • Name
    is_ready_to_ship
    Required
    Optional
    Description

    Parameter keeps only the products that are ready to ship when set to true.

  • Name
    has_free_sample
    Required
    Optional
    Description

    Parameter keeps only the products with free samples when set to true.

  • Name
    price_min
    Required
    Optional
    Description

    Parameter defines the lowest starting unit price, in USD whatever the currency.

  • Name
    price_max
    Required
    Optional
    Description

    Parameter defines the highest starting unit price, in USD whatever the currency. It must be at least price_min.

  • Name
    moq_min
    Required
    Optional
    Description

    Parameter defines the lowest minimum order quantity.

  • Name
    moq_max
    Required
    Optional
    Description

    Parameter defines the highest minimum order quantity, such as 10 for products you can order in small amounts. It must be at least moq_min.

Pagination

  • Name
    page
    Required
    Optional
    Description

    Parameter defines the page of results, from 1 to 100. It defaults to 1, and pagination.next gives the next page.

  • Name
    num
    Required
    Optional
    Description

    Parameter defines the number of products per page, from 1 to 100. It defaults to 48.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to alibaba_search.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=alibaba_search&q=bluetooth+speaker
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "alibaba_search",
  "q": "bluetooth speaker"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_vjcgEaZzRxLjOvcUZaw1YGGw",
    "status": "Success",
    "created_at": "2026-11-19T14:57:08Z",
    "request_time_taken": 3.43,
    "parsing_time_taken": 0.13,
    "total_time_taken": 3.55,
    "request_url": "https://www.alibaba.com/trade/search?SearchText=bluetooth+speaker",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_vjcgEaZzRxLjOvcUZaw1YGGw.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_vjcgEaZzRxLjOvcUZaw1YGGw"
  },
  "search_parameters": {
    "engine": "alibaba_search",
    "q": "bluetooth speaker"
  },
  "organic_results": [
    {
      "position": 1,
      "product_id": "1601764704205",
      "title": "Modern Desk Smart Artificial Plant With Flower Pot Usb Use Has Bluetooth, Speakers, White Noise, Lighting",
      "link": "https://www.alibaba.com/product-detail/Modern-Desk-Smart-Artificial-Plant-With_1601764704205.html",
      "price": "$9.99",
      "extracted_price_min": 9.99,
      "extracted_price_max": 9.99,
      "minimum_order": "1 square centimeter",
      "extracted_minimum_order": 1,
      "unit": "square centimeter",
      "category": "Artificial Plant",
      "category_id": "100008969",
      "thumbnail": "https://s.alicdn.com/@sc04/kf/H09c779856ce24eeab4ee6977a2b1125fu.png_300x300.png",
      "images": [
        "https://s.alicdn.com/@sc04/kf/H09c779856ce24eeab4ee6977a2b1125fu.png_300x300.png",
        "..."
      ],
      "has_video": true,
      "is_sponsored": true,
      "supplier": {
        "name": "Dongguan Weixuan Household Products Co., Ltd.",
        "id": "233949033",
        "link": "https://dgwx.en.alibaba.com/company_profile.html",
        "country": "China",
        "country_code": "CN",
        "years_on_platform": 3,
        "is_gold_supplier": true,
        "is_verified": false,
        "is_verified_pro": false,
        "has_trade_assurance": true,
        "response_rate": "100.0%",
        "response_time": "≤1h",
        "rating": 4.8,
        "reviews": 10,
        "ratings": {
          "product": 4.9,
          "service": 4.8,
          "shipping": 4.9
        }
      }
    },
    "..."
  ],
  "pagination": {
    "current": 1,
    "next": 2
  }
}

Verified Suppliers Only

GET
https://www.searchapi.io/api/v1/search?engine=alibaba_search&is_verified_supplier=true&q=office+chair
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "alibaba_search",
  "q": "office chair",
  "is_verified_supplier": "true"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_7UF2R3vTFK356TRdDWir8qFz",
    "status": "Success",
    "created_at": "2026-11-19T14:57:12Z",
    "request_time_taken": 8.86,
    "parsing_time_taken": 0.02,
    "total_time_taken": 8.88,
    "request_url": "https://www.alibaba.com/trade/search?SearchText=office+chair&assessmentCompany=true",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_7UF2R3vTFK356TRdDWir8qFz.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_7UF2R3vTFK356TRdDWir8qFz"
  },
  "search_parameters": {
    "engine": "alibaba_search",
    "q": "office chair",
    "is_verified_supplier": true
  },
  "organic_results": [
    {
      "position": 1,
      "product_id": "1600460041390",
      "title": "Kabel New Design Nylon Base Swivel Executive Mesh Ergonomic Office Chair",
      "link": "https://www.alibaba.com/product-detail/Kabel-New-Design-Nylon-Base-Swivel_1600460041390.html?s=p",
      "price": "$24.20-26.70",
      "extracted_price_min": 24.2,
      "extracted_price_max": 26.7,
      "price_tiers": [
        {
          "min_quantity": 40,
          "max_quantity": 689,
          "price": "$26.70",
          "extracted_price": 26.7
        },
        "..."
      ],
      "minimum_order": "40 pieces",
      "extracted_minimum_order": 40,
      "unit": "piece",
      "category": "Office Chairs",
      "category_id": "201715704",
      "thumbnail": "https://s.alicdn.com/@sc04/kf/H5c2d9fb496474adb98b16a87ff577e0cd.jpg_300x300.jpg",
      "images": [
        "https://s.alicdn.com/@sc04/kf/H5c2d9fb496474adb98b16a87ff577e0cd.jpg_300x300.jpg",
        "..."
      ],
      "has_video": true,
      "is_sponsored": true,
      "supplier": {
        "name": "Anji Ka Bei Long Furniture Co., Ltd.",
        "id": "50059973",
        "link": "https://zjenjoy.en.alibaba.com/company_profile.html",
        "country": "China",
        "country_code": "CN",
        "years_on_platform": 21,
        "is_gold_supplier": true,
        "is_verified": true,
        "is_verified_pro": false,
        "has_trade_assurance": true,
        "response_rate": "100.0%",
        "response_time": "≤1h",
        "rating": 5.0,
        "reviews": 2,
        "ratings": {
          "product": 5.0,
          "service": 5.0,
          "shipping": 5.0
        }
      }
    },
    "..."
  ],
  "pagination": {
    "current": 1,
    "next": 2
  }
}

Ready to Ship, Order 10 or Fewer

Ready to Ship, Order 10 or Fewer
GET
https://www.searchapi.io/api/v1/search?engine=alibaba_search&is_ready_to_ship=true&moq_max=10&q=led+strip+lights
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "alibaba_search",
  "q": "led strip lights",
  "is_ready_to_ship": "true",
  "moq_max": "10"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_s9mpqKyfcgiWsGZG0fAXQfCf",
    "status": "Success",
    "created_at": "2026-11-19T14:57:21Z",
    "request_time_taken": 9.47,
    "parsing_time_taken": 0.01,
    "total_time_taken": 9.49,
    "request_url": "https://www.alibaba.com/trade/search?SearchText=led+strip+lights&moqt=10&productTag=1200000228",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_s9mpqKyfcgiWsGZG0fAXQfCf.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_s9mpqKyfcgiWsGZG0fAXQfCf"
  },
  "search_parameters": {
    "engine": "alibaba_search",
    "q": "led strip lights",
    "moq_max": 10,
    "is_ready_to_ship": true
  },
  "organic_results": [
    {
      "position": 1,
      "product_id": "1601360558725",
      "title": "SNOWMAN ARGB Cable Light up LED Strip for PSU Extensions 5V 3 Pin ARGB Sync Compatible with 8-Pin 16-Pin GPU 24pin Motherboard",
      "link": "https://www.alibaba.com/product-detail/SNOWMAN-ARGB-Cable-Light-up-LED_1601360558725.html",
      "price": "$5.74-6.62",
      "extracted_price_min": 5.74,
      "extracted_price_max": 6.62,
      "price_tiers": [
        {
          "min_quantity": 1,
          "max_quantity": 99,
          "price": "$6.62",
          "extracted_price": 6.62
        },
        "..."
      ],
      "minimum_order": "1 piece",
      "extracted_minimum_order": 1,
      "unit": "piece",
      "category": "Other Computer Accessories",
      "category_id": "70899",
      "thumbnail": "https://s.alicdn.com/@sc04/kf/H45926757b8384450a5e57e63130445acB.jpg_300x300.jpg",
      "images": [
        "https://s.alicdn.com/@sc04/kf/H45926757b8384450a5e57e63130445acB.jpg_300x300.jpg",
        "..."
      ],
      "has_video": true,
      "certifications": [
        "ROHS",
        "CE",
        "FCC"
      ],
      "is_sponsored": true,
      "supplier": {
        "name": "Dongguan Bingman Electronic Technology Co., Ltd.",
        "id": "244758013",
        "link": "https://bingman.en.alibaba.com/company_profile.html",
        "country": "China",
        "country_code": "CN",
        "years_on_platform": 5,
        "is_gold_supplier": true,
        "is_verified": true,
        "is_verified_pro": false,
        "has_trade_assurance": true,
        "response_rate": "99.9%",
        "rating": 4.7,
        "reviews": 180,
        "ratings": {
          "product": 4.9,
          "service": 4.6,
          "shipping": 4.6
        },
        "audits": [
          "ISO"
        ]
      }
    },
    "..."
  ],
  "pagination": {
    "current": 1,
    "next": 2
  }
}

In German and Euros

GET
https://www.searchapi.io/api/v1/search?currency=EUR&engine=alibaba_search&language=de&q=yoga+mat
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "alibaba_search",
  "q": "yoga mat",
  "language": "de",
  "currency": "EUR"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_WYZWFHOgNcbC1mhNz2PXXpMq",
    "status": "Success",
    "created_at": "2026-11-19T14:57:30Z",
    "request_time_taken": 2.86,
    "parsing_time_taken": 0.03,
    "total_time_taken": 2.89,
    "request_url": "https://www.alibaba.com/trade/search?SearchText=yoga+mat",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_WYZWFHOgNcbC1mhNz2PXXpMq.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_WYZWFHOgNcbC1mhNz2PXXpMq"
  },
  "search_parameters": {
    "engine": "alibaba_search",
    "q": "yoga mat",
    "language": "de",
    "currency": "EUR"
  },
  "organic_results": [
    {
      "position": 1,
      "product_id": "1601617846699",
      "title": "SHENGDE Großhandel Hochwertige umwelt freundliche faltbare Kinder rutsch feste doppelseitige Reise Fitness Workouts Trendy TPE Yoga Mat",
      "link": "https://www.alibaba.com/product-detail/SHENGDE-Wholesale-High-Quality-Eco-Friendly_1601617846699.html",
      "price": "2,44-2,68 €",
      "extracted_price_min": 2.44,
      "extracted_price_max": 2.68,
      "price_tiers": [
        {
          "min_quantity": 300,
          "max_quantity": 499,
          "price": "2,68 €",
          "extracted_price": 2.68
        },
        "..."
      ],
      "minimum_order": "300 Stück",
      "extracted_minimum_order": 300,
      "unit": "Stück",
      "category": "Yogamatten",
      "category_id": "201273273",
      "thumbnail": "https://s.alicdn.com/@sc04/kf/H9783cf64e5af453f8bc3c3925cfb28f3I.jpg_300x300.jpg",
      "images": [
        "https://s.alicdn.com/@sc04/kf/H9783cf64e5af453f8bc3c3925cfb28f3I.jpg_300x300.jpg",
        "..."
      ],
      "has_video": true,
      "is_sponsored": true,
      "supplier": {
        "name": "Fuqing Shengde Ruibo Technology Co., Ltd.",
        "id": "282993354",
        "link": "https://shengdeproduct.en.alibaba.com/de_DE/company_profile.html",
        "country": "China",
        "country_code": "CN",
        "years_on_platform": 3,
        "is_gold_supplier": true,
        "is_verified": true,
        "is_verified_pro": false,
        "has_trade_assurance": true,
        "response_rate": "95.6%"
      }
    },
    "..."
  ],
  "pagination": {
    "current": 1,
    "next": 2
  }
}