# Pmsearch Jd — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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.

> Access detailed information about judicial auction listings on JD Paimai, including evaluation price, auction status, transaction price, starting bid, and property area. Retrieve full bid histories for any auction item in real time.

**Category:** Marketplaces | **Website:** [pmsearch.jd.com/](https://pmsearch.jd.com/) | **Docs:** [parse.bot/marketplace/ad5ab6df-cde0-4056-a4fb-7d99aba7acd6/pmsearch-jd-com-api](https://parse.bot/marketplace/ad5ab6df-cde0-4056-a4fb-7d99aba7acd6/pmsearch-jd-com-api)

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

## Access

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

## Endpoints

### get_bid_records

Get bidding records and history for a specific auction item. Returns a list of bids with bidder usernames, prices, and timestamps. Items with no bids return an empty bids array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | The unique paimaiId of the auction item (numeric string, e.g. '310131146'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pmsearch-jd-com-api-ad5ab6df/get_bid_records \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>"}'
```

### get_item_detail

Get details for a specific auction item by its paimai ID. Returns pricing, status, timing, location, and other auction metadata. Combines data from the basic info and real-time data APIs. Each item has a numeric paimai_id that uniquely identifies it on the platform.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | The unique paimaiId of the auction item (numeric string, e.g. '310131146'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pmsearch-jd-com-api-ad5ab6df/get_item_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>"}'
```