# 1688 search: `POST /v1/1688/search`

Cost: 2 credits (2 per page (an empty page and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/1688-search

One page (up to 60) of 1688.com products for a keyword.

Each product carries its price in yuan, quantity price tiers, minimum
order quantity, units sold, repeat-buyer rate, image, province and city,
and the supplier: company, business type (manufacturer or wholesaler),
verified years, factory badges and service scores. Sponsored products
are flagged with ``is_ad``. Sort by price or sales, or filter by price
range or province. An empty page is not charged.

Request body (JSON):

- `q` (string; required; min length 1, max length 100): Search keyword. Chinese finds the most products; English matches products whose titles contain the English words.
- `page` (integer; optional; default 1; min 1, max 2000): 1-based results page. Only the first 2,000 results can be paged through.
- `page_size` (integer; optional; default 20; min 1, max 60): Products per page (1-60).
- `sort` (string | null; optional; one of price_asc, price_desc, sales): Sort order: price_asc (cheapest first), price_desc, or sales (best recent sellers first). Default: the site's relevance order. Sorted pages carry no sponsored products.
- `min_price_cny` (number | null; optional; min 0): Lowest price in Chinese yuan (CNY).
- `max_price_cny` (number | null; optional; min 0): Highest price in Chinese yuan (CNY). The filter uses the site's lowest listed price, so a product priced per variant can show a higher price; sponsored products can fall outside the range.
- `province` (string | null; optional; max length 40): Only suppliers in this mainland China province, in English or Chinese, e.g. 'Guangdong', 'Zhejiang' or '浙江'.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
