# Yangkeduo — 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.

> Browse Pinduoduo's homepage feed, explore product categories, and discover trending search terms to stay updated on popular items. Search for specific products, get detailed product information, and receive search suggestions to find exactly what you're looking for on the platform.

**Category:** E-commerce | **Website:** [mobile.yangkeduo.com/](https://mobile.yangkeduo.com/) | **Docs:** [parse.bot/marketplace/9cc64928-5b34-4e2d-8221-f826cbb2ca30/mobile-yangkeduo-com-api](https://parse.bot/marketplace/9cc64928-5b34-4e2d-8221-f826cbb2ca30/mobile-yangkeduo-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-mobile-yangkeduo-com-api-9cc64928/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_list

Retrieves the list of top-level product categories from Pinduoduo. Each category includes an integer ID and Chinese name. Useful for understanding the product taxonomy; no pagination.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mobile-yangkeduo-com-api-9cc64928/get_category_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_homepage_feed

Retrieves the initial product feed from the Pinduoduo mobile homepage. Returns a list of featured products with pricing (in cents), sales data, and thumbnail images. No pagination — returns a single page of promoted products curated by the platform.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mobile-yangkeduo-com-api-9cc64928/get_homepage_feed \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_trending_search_terms

Retrieves the currently trending search terms on Pinduoduo. Returns a flat list of popular search query strings. Refreshed frequently; results vary over time. No pagination.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mobile-yangkeduo-com-api-9cc64928/get_trending_search_terms \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_suggest

Returns search suggestions (autocomplete) for a given query string on Pinduoduo. Useful for discovering related search terms or building type-ahead UIs. Results are Chinese-language terms related to the query. No pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to get suggestions for (Chinese text, e.g. '手机', '耳机'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mobile-yangkeduo-com-api-9cc64928/search_suggest \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```