# JD.com — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for products on JD.com, explore related keywords, retrieve product recommendations, and access the latest corporate news from China's major e-commerce platform. Returns real-time product details including prices, ratings, and stock availability.

**Category:** E-commerce | **Website:** [jd.com/](https://jd.com/) | **Docs:** [parse.bot/marketplace/11c7f7be-4855-4960-bd6b-1e2cf49689bc/jd-com-api](https://parse.bot/marketplace/11c7f7be-4855-4960-bd6b-1e2cf49689bc/jd-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-jd-com-api-11c7f7be/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get corporate news

Fetch latest corporate news articles from JD.com's newsroom. Returns articles with title, excerpt, categories, publication timestamp, and direct link. The limit param controls how many articles the server returns.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of news articles to return. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-jd-com-api-11c7f7be/get_corporate_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Get product recommendations

Get recommended products for a given keyword from JD.com. Recommendations are loosely associated with the query and may span multiple categories. Paginates via integer page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based). |
| `query` | string | Yes | Search keyword to base recommendations on. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-jd-com-api-11c7f7be/get_product_recommendations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### Get related keywords

Get related search keywords for a given query on JD.com. Returns alternative and refined keyword suggestions that shoppers commonly use alongside the input query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to find related terms for. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-jd-com-api-11c7f7be/get_related_keywords \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### Search products

Full-text product search on JD.com. Matches the query keyword against product titles. Returns products with pricing, ratings, and comment counts. Paginates via integer page number; stops on first empty page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based). |
| `query` | string | Yes | Search keyword (e.g. '手机', '笔记本电脑'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-jd-com-api-11c7f7be/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```