jd.com APIjd.com ↗
Search JD.com products, get recommendations, related keywords, and corporate news via 4 endpoints. Returns SKU, price, ratings, and shop data.
curl -X GET 'https://api.parse.bot/scraper/1ee95c11-c5ec-44b3-a893-7f64c6f4e6c0/search_products?page=1&query=%E6%89%8B%E6%9C%BA' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on JD.com using the public re.jd.com endpoint. Returns product details including SKU, title, price, image, and comment counts. Results are paginated.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword (e.g. '手机', '笔记本电脑'). |
{
"type": "object",
"fields": {
"page": "integer, the requested page number",
"query": "string, the search keyword used",
"products": "array of product objects, each containing sku_id, title, price, image_url, click_url, comment_count, good_rate, and shop_id"
},
"sample": {
"data": {
"page": 1,
"query": "手机",
"products": [
{
"price": "8499.00",
"title": "OPPO Find X9 Ultra 16GB+512GB",
"sku_id": "100250023001",
"shop_id": 1000004065,
"click_url": "https://ccc-x.jd.com/dsp/nc?ext=...",
"good_rate": 99,
"image_url": "https://img10.360buyimg.com/n1/jfs/t1/420670/28/13521/46779/69e72e1fF2762761c/0083320320b3efa3.jpg",
"comment_count": "1万+"
}
]
},
"status": "success"
}
}About the jd.com API
The JD.com API exposes 4 endpoints covering product search, recommendations, related keyword discovery, and corporate newsroom content from one of China's largest e-commerce platforms. The search_products endpoint returns paginated product listings with fields like sku_id, price, comment_count, good_rate, and shop_id — giving developers structured access to live catalog data without building a custom crawler.
Product Search and Recommendations
The search_products endpoint accepts a required query string (e.g. 手机 or 笔记本电脑) and an optional page integer for pagination. Each product object in the products array includes sku_id, title, price, image_url, click_url, comment_count, good_rate, and shop_id. The get_product_recommendations endpoint takes the same parameters but returns a recommendations array — note that results are not strictly filtered to the query keyword, so the response may include loosely related items.
Related Keywords and Search Intelligence
The get_related_keywords endpoint takes a single query string and returns a keywords array of related search terms as strings. This is useful for expanding keyword sets for price monitoring tools, SEO research targeting the Chinese market, or building autocomplete features that align with JD.com's own search behavior.
Corporate News
The get_corporate_news endpoint (POST) pulls articles from JD.com's corporate newsroom. Each article object in the news array includes id, title, excerpt, categories, banner, alt_banner, and a created Unix timestamp. An optional limit integer caps the number of returned articles. This endpoint covers investor relations content, product announcements, and company updates.
- Monitor price changes on specific JD.com SKUs by polling
search_productswith targeted queries - Build a product comparison tool using
sku_id,price, andgood_ratefields from search results - Expand Chinese-language keyword lists for SEO or ad campaigns using
get_related_keywords - Track JD.com corporate announcements and press releases via
get_corporate_newswithcreatedtimestamps - Aggregate seller data by collecting
shop_idvalues across paginated search results - Surface similar product suggestions in a shopping app using
get_product_recommendations - Research consumer sentiment signals using
comment_countandgood_rateacross product categories
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does JD.com have an official developer API?+
What does `search_products` return that `get_product_recommendations` does not?+
search_products returns comment_count and good_rate fields per product, which indicate review volume and positive rating percentage. The get_product_recommendations response omits those fields, returning only sku_id, title, price, image_url, click_url, and shop_id.Are product reviews or individual review text available through this API?+
comment_count and good_rate as aggregate signals but does not return individual review text, reviewer profiles, or star breakdowns. You can fork it on Parse and revise to add a review-detail endpoint.Does the API cover product inventory or stock status?+
How does pagination work across the search endpoints?+
search_products and get_product_recommendations accept an optional page integer. The response echoes the requested page value alongside the results array. There is no total_pages or total_results field returned, so you would need to increment the page parameter and detect an empty results array to determine the last page.