EveryData platform API
1688 API
For 1688, this page covers 1688 product search results and individual product details through 2 callable views—`search`, `product_detail`—without merging their inputs or response scopes.
1688 begins with `search`, where `keyword` selects matching public results; the adjacent `product_detail` view uses `url` for one product record, leaving other capabilities unclaimed.
- Endpoint
- POST /api/v1/social
- Capabilities
- 2
- Per 1,000
- $1.389
Available capabilities
Compare the 1688 actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search public results on 1688. Accepts these parameters: | keyword | city, max_price, min_price, sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · title · text · price_min · price_max · currency · min_order_quantity · order_count · repurchase_rate · category · city · province · supplier_name · is_out_of_stock · supports_dropship · images · platform |
product_detailProduct details Retrieve product details from 1688. Accepts these parameters: | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · title · text · price_min · price_max · currency · price_tiers · min_order_quantity · stock · sold_count · category · unit · supplier_name · supplier_fans · supplier_founded_year · supplier_type · supplier_favorited_count · supports_dropship · supports_sampling · is_out_of_stock · skus · images · platform · name · price · min_quantity |
What does each 1688 action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the 1688 search parameters mean?
Search public results on 1688. Accepts these parameters: keyword, max_price, sort, min_price, and city. Returns these fields: price_max, title, price_min, and supplier_name.
keywordRequired- Specifies the search term for 1688 wholesale products (for example, insulated mugs or cardboard boxes). Use product terms rather than store names or offerIds; minimum order quantities and tier pricing return inside item details.
cityOptional- Filters 1688 wholesale item queries by city name text. This filter does not reflect account locations, change returned seller addresses, or guarantee persistent filtering on single-product detail requests.
max_priceOptional- Filters wholesale items by maximum unit price as a numeric value. It operates alongside min_price to bound price ranges rather than tier order quantities, and it may not cover every SKU variant or volume discount tier.
min_priceOptional- Filters wholesale items by minimum unit price as a numeric value. This parameter sets item criteria rather than minimum order quantities or API spend limits, and returned tier pricing varies by order volume.
sortOptional- Sorts search items by relevance (default for search), popular, price_asc, or price_desc. Sorting criteria do not guarantee exact sales figures or total transaction amounts in the payload.Allowed values:
popularprice_ascprice_descrelevance
What do the 1688 product_detail parameters mean?
Retrieve product details from 1688. Accepts these parameters: url. Returns these fields: price_min, text, stock, and supports_sampling.
urlRequired- Specifies the target product for product_detail using a https://detail.1688.com/offer/<offerId>.html URL, a URL containing an offerId query parameter, or a raw numeric offerId. Store storefront URLs and search results URLs are not supported.1688: Products, Specifications, and Minimum Order Quantities1688 procurement documentation distinguishes among product offerId, specification specId, and purchase quantity, and separately validates minimum order quantity. These terms are cited here for explanatory purposes only; this endpoint does not create or preview purchase orders.Checked
How to use the 1688 API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"alibaba1688","action":"search","params":{"keyword":"<keyword>"}}'
1688 API questions
What can I retrieve with the 1688 API?
Set platform to alibaba1688. The current catalog lists search and product details. These action names identify different 1688 objects or views; they are not interchangeable search modes.
Which input starts a 1688 `search` request?
Specifies the search term for 1688 wholesale products (for example, insulated mugs or cardboard boxes). Use product terms rather than store names or offerIds; minimum order quantities and tier pricing return inside item details. Send it as keyword inside params.
Which fields can 1688 `search` return?
Its declared schema includes title, text, price_min, and price_max. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every 1688 action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.