---
title: "Scrape Alibaba.com product search results"
method: POST
path: "/marketplace/alibaba-search"
tags: ["Plugins"]
---

# Scrape Alibaba.com product search results

`POST /marketplace/alibaba-search`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/marketplace/alibaba-search`
- Auth: API key in header `x-scrapeunblocker-key`

Searches Alibaba.com for `q` and returns the products as JSON: `productId`, `title`, `url`, `image`/`images`, `priceText` with `priceMin`/`priceMax` and `currency` (USD), `priceTiers` (price per quantity range), promotion price, `moq` + `moqUnit` (minimum order), `sold`, store `rating` + `reviewsCount`, `leadTimeDays`, `category`, `certifications`, `sponsored`, and the `supplier` (name, store and profile URL, country, `yearsOnAlibaba`, `verified`, `verifiedPro`, `goldSupplier`, `tradeAssurance`, `responseRate`). Sort by relevance or sales, filter with `verified`, `verified_pro`, `trade_assurance` and `supplier_country`, and collect up to `max_results` across pages (48 per page, each page billed as one request, see `pagesFetched`). Each product also has a `thumbnail` (300x300 rendition of `image`, which is the full-size original). Paging: `nextPage` is the next Alibaba page not yet returned (pass it as `page` to continue) and `hasMore` says whether there is one; when `max_results` ends inside a page, the rest of that page is not returned (`droppedFromLastPage`), so use multiples of 48 to get every product.

## Query parameters

- `q` string, nullable: What to search, e.g. 'bluetooth speaker' or 'yoga mat'. Any language.
- `page` integer: 1-based results page to start from (1-100). Use `nextPage` of a previous response to continue.
- `max_results` integer: Products to collect across pages (1-480); Alibaba serves 48 per page and each page fetched is billed as one request.
- `sort` string: Order: relevance, sales (sales = most sold in the last 180 days first).
- `verified` boolean: Only Verified suppliers (third-party inspected).
- `verified_pro` boolean: Only Verified PRO suppliers.
- `trade_assurance` boolean: Only products covered by Trade Assurance.
- `supplier_country` string, nullable: Only suppliers located in this country (ISO-2), e.g. CN, US, IN.
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Leave blank to let the API pick.

## Response `200`

JSON with a `products` array plus paging totals.

- unknown

## Other responses

- `400`: Invalid parameters.
- `422`: Validation Error
- `502`: Blocked by Alibaba on every attempt, no results page returned, or the call did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)