> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt > Use this file to discover all available pages before exploring further. # Scrape Alibaba.com product search results > 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. ## OpenAPI ````yaml /api-reference/openapi.json post /marketplace/alibaba-search openapi: 3.1.0 info: title: ScrapeUnblocker API description: >- Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate every request with the `x-scrapeunblocker-key` header. Documented here: page-source extraction, Google SERP scraping, image fetch, and the dedicated plugin endpoints (search engines, marketplaces, reviews, travel, social and more). All other paths exist for internal operations and are intentionally hidden from this spec. version: 3.0.0 servers: - url: https://api.scrapeunblocker.com description: Production security: [] paths: /marketplace/alibaba-search: post: tags: - Plugins summary: Scrape Alibaba.com product search results description: >- 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. operationId: alibaba_search_marketplace_alibaba_search_post parameters: - name: q in: query required: false schema: anyOf: - type: string - type: 'null' description: >- What to search, e.g. 'bluetooth speaker' or 'yoga mat'. Any language. title: Q description: >- What to search, e.g. 'bluetooth speaker' or 'yoga mat'. Any language. - name: page in: query required: false schema: type: integer description: >- 1-based results page to start from (1-100). Use `nextPage` of a previous response to continue. default: 1 title: Page description: >- 1-based results page to start from (1-100). Use `nextPage` of a previous response to continue. - name: max_results in: query required: false schema: type: integer description: >- Products to collect across pages (1-480); Alibaba serves 48 per page and each page fetched is billed as one request. default: 48 title: Max Results description: >- Products to collect across pages (1-480); Alibaba serves 48 per page and each page fetched is billed as one request. - name: sort in: query required: false schema: type: string description: >- Order: relevance, sales (sales = most sold in the last 180 days first). default: relevance title: Sort description: >- Order: relevance, sales (sales = most sold in the last 180 days first). - name: verified in: query required: false schema: type: boolean description: Only Verified suppliers (third-party inspected). default: false title: Verified description: Only Verified suppliers (third-party inspected). - name: verified_pro in: query required: false schema: type: boolean description: Only Verified PRO suppliers. default: false title: Verified Pro description: Only Verified PRO suppliers. - name: trade_assurance in: query required: false schema: type: boolean description: Only products covered by Trade Assurance. default: false title: Trade Assurance description: Only products covered by Trade Assurance. - name: supplier_country in: query required: false schema: anyOf: - type: string - type: 'null' description: Only suppliers located in this country (ISO-2), e.g. CN, US, IN. title: Supplier Country description: Only suppliers located in this country (ISO-2), e.g. CN, US, IN. - name: proxy_country in: query required: false schema: anyOf: - type: string - type: 'null' description: Exit-IP country (ISO-2). Blank for a smart exit. title: Proxy Country description: Exit-IP country (ISO-2). Blank for a smart exit. responses: '200': description: JSON with a `products` array plus paging totals. content: application/json: schema: {} '400': description: Invalid parameters. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '502': description: Blocked by Alibaba on every attempt, or no results page returned. '504': description: Fetch timed out. security: - ScrapeUnblockerKey: [] components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ScrapeUnblockerKey: type: apiKey in: header name: x-scrapeunblocker-key description: Your ScrapeUnblocker API key. Apply on every request. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.