Yangkeduo APImobile.yangkeduo.com ↗
Access Pinduoduo homepage product feeds, category lists, trending searches, and search suggestions via the mobile.yangkeduo.com API.
What is the Yangkeduo API?
This API covers 4 endpoints against Pinduoduo's mobile platform (mobile.yangkeduo.com), returning product feeds, category trees, trending search terms, and autocomplete suggestions. The get_homepage_feed endpoint alone surfaces 7 fields per product — including goods_id, price in cents, market_price, and sales_tip — giving you a live snapshot of what Pinduoduo is currently featuring to shoppers.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/78a17ce7-83e8-4e6b-9aa3-f1d605cdc433/get_homepage_feed' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace mobile-yangkeduo-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Pinduoduo SDK — browse products, categories, trends, and suggestions."""
from parse_apis.pinduoduo_scraper_api import Pinduoduo, Product, Category, NotFoundError
client = Pinduoduo()
# List homepage products — each has price in cents, sales data, thumbnails.
for product in client.products.list(limit=5):
print(product.goods_name, f"¥{product.price / 100:.2f}", product.sales_tip)
# Browse all top-level categories.
for category in client.categories.list(limit=5):
print(category.opt_id, category.opt_name)
# Discover what's trending right now.
trending = client.trendingsearches.list(limit=3).first()
if trending:
print("Top trend:", trending)
# Use a trending term to get autocomplete suggestions.
try:
suggestion = client.suggestions.search(query="手机", limit=1).first()
if suggestion:
print("First suggestion:", suggestion)
except NotFoundError as exc:
print(f"Query issue: {exc}")
print("exercised: products.list / categories.list / trendingsearches.list / suggestions.search")
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.
No input parameters required.
{
"type": "object",
"fields": {
"products": "array of product objects with goods_id, goods_name, price, market_price, sales_tip, thumb_url, link_url"
},
"sample": {
"data": {
"products": [
{
"price": 578,
"goods_id": 685663512179,
"link_url": "goods.html?goods_id=685663512179",
"sales_tip": "全店总售399万+件",
"thumb_url": "https://img.pddpic.com/mms-material-img/2024-12-17/27311476-814e-434f-8f11-dc4ceca1a1d7.jpeg.a.jpeg",
"goods_name": "垃圾袋家用手提式加厚卫生间客厅中大号厨房背心清洁便宜垃圾袋子",
"market_price": 2100
}
]
},
"status": "success"
}
}About the Yangkeduo API
Product Feed and Pricing Data
The get_homepage_feed endpoint returns an array of featured products from Pinduoduo's mobile homepage. Each product object includes goods_id, goods_name, price (denominated in cents), market_price, sales_tip (a human-readable sales volume hint), thumb_url, and link_url. This makes it straightforward to track promotional pricing deltas — compare price against market_price to compute discount depth on featured items.
Categories and Discovery
get_category_list returns the full set of top-level product categories. Each entry carries an opt_id integer, an opt_name string, and an image_url (which may be null for some categories). This is useful for mapping Pinduoduo's category taxonomy to your own classification system or for scoping downstream queries.
Trending Terms and Search Suggestions
get_trending_search_terms returns a flat array of strings representing what users are actively searching on Pinduoduo at the time of the request — no input parameters required. For query-level autocomplete, search_suggest accepts a required query string (e.g., 手机 for mobile phones) and returns an array of suggestion strings. Together, these two endpoints let you monitor shifting consumer demand or power a keyword research workflow without needing to interact with the search results themselves.
Coverage Notes
All four endpoints operate without authentication parameters. Price values from get_homepage_feed are integers in Chinese fen (1/100 of a RMB yuan), so divide by 100 for display. The homepage feed reflects the unauthenticated default view — personalized or user-specific feeds are not exposed.
The Yangkeduo API is a managed, monitored endpoint for mobile.yangkeduo.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when mobile.yangkeduo.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official mobile.yangkeduo.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track discount depth on Pinduoduo homepage products by comparing
priceandmarket_pricefields over time. - Build a Pinduoduo category browser by mapping
opt_idandopt_namevalues fromget_category_listto your own taxonomy. - Monitor Chinese consumer trends by polling
get_trending_search_termsdaily and charting term frequency shifts. - Power an autocomplete widget for a Pinduoduo-integrated tool using
search_suggestwith a livequeryparameter. - Seed a competitive pricing dataset by ingesting homepage
goods_id,goods_name, andsales_tipfields on a schedule. - Identify high-velocity product categories by cross-referencing trending terms against the category list.
| 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 | 100 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 Pinduoduo have an official public developer API?+
What does `get_homepage_feed` return, and how are prices represented?+
goods_id, goods_name, price, market_price, sales_tip, thumb_url, and link_url. Both price and market_price are integers denominated in Chinese fen — divide by 100 to convert to RMB yuan.Does the API support paginated or filtered product search results?+
Does `get_category_list` return subcategories or only top-level categories?+
opt_id, opt_name, and image_url, but nested subcategory trees are not included. You can fork the API on Parse and revise it to add an endpoint that fetches subcategories for a given opt_id.