# Xiaohongshu PGY trending notes API > The trending notes of PGY’s content square: eight boards (Xiaohongshu hot, product seeding, e-commerce promotion, PGY sponsored, lead collection, e-commerce hot, seeding to shop, app promotion), whole or narrowed to some words, over the last 3, 7, 14 or 30 days, image or video notes alone if wanted. Each with title, time published, reads, likes, saves, comments, pictures and the creator’s ID, name and followers. Each board holds its top 100. Canonical page: https://okdata.online/apis/xiaohongshu/pgy/notes/trending/ - **Endpoint**: `GET /v1/xiaohongshu/pgy/notes/trending` - **ID**: `xiaohongshu.pgy.notes.trending` - **Price**: $0.04 per call · about 34 notes per page - **Returns**: a page of about 34 notes (`data.items`, Post objects) - **Status**: preview - **Good for**: Trend research, Content research ## Price One call costs $0.04 and returns one page of about 34 notes. Collecting 1,000 notes takes about 30 calls, $1.20 in total. Each page is a separate call; failed calls are not charged. ## Parameters | Name | Type | Required | Default | Description | |---|---|---|---|---| | `board` | string: hot / seeding / shop_promo / pgy / leads / shop_hot / direct_seeding / app_promo | no | `hot` | Which board: hot (Xiaohongshu hot, the default), seeding (product seeding), shop_promo (e-commerce promotion), pgy (PGY sponsored), leads (lead collection), shop_hot (e-commerce hot), direct_seeding (seeding to shop) or app_promo (app promotion). | | `query` | string | no | | Only notes about these words, matched against the whole note; leave out for the whole board. (e.g. `咖啡`) | | `window` | string: 3d / 7d / 14d / 30d | no | `7d` | Over how many of the last days: 3, 7 (the default), 14 or 30. | | `type` | string: image / video | no | | Image notes or video notes alone; both when left out. | | `cursor` | string | no | | Opaque cursor from page.next_cursor of the previous call. Each page is a separate call. | | `view` | string: compact / standard / full | no | `standard` | How much of each object comes back. full adds platform-specific fields under ext. | | `fields` | string[] | no | | Fields to keep, by path (author.name), to save tokens. In a query string: comma-separated. | cursor, view and fields work as described in [Requests](https://okdata.online/docs/requests/). ## Returned fields Each item is a [Post](https://okdata.online/docs/objects/post/). | Field | Type | Description | |---|---|---| | `id` | string | Post ID on the platform. | | `url` | string | Link to the post. | | `type` | string | What kind of post it is. | | `title` | string \| null | Title, where the platform has one (videos, notes, articles). | | `text` | string | Caption, body or description as plain text; articles come as Markdown. | | `lang` | string \| null | Language code, as reported or detected. | | `published_at` | string \| null | When it was published, ISO 8601 in UTC; null only where the source gives no time (wechat_mp.articles.metrics, wechat_channels.videos.metrics, youtube.channels.videos.list with type=short), then listed in meta.unavailable. | | `author` | AccountRef | Who posted it. | | `metrics` | Metrics | Counts at fetch time; a count the platform hides is null. | | `images` | string[] \| null | Image URLs for image posts and notes. | | `hashtags` | string[] \| null | Hashtags or topics, without the # sign. | | `ext` | object | Platform-specific extras. Only returned with view=full. | ## Request examples ### cURL ```bash curl "https://api.okdata.online/v1/xiaohongshu/pgy/notes/trending" \ -H "Authorization: Bearer $OKDATA_API_KEY" ``` ### Python ```python import os import requests resp = requests.get( "https://api.okdata.online/v1/xiaohongshu/pgy/notes/trending", headers={"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}, params={}, timeout=60, ) body = resp.json() if body["code"] != "ok": raise RuntimeError(f"{body['code']}: {body['message']} (charged: {body['charged']})") for row in body["data"]["items"]: print(row["id"], row["metrics"]["likes"], row["text"][:60]) print("cost: $" + body["meta"]["billing"]["amount"]) ``` ### TypeScript ```ts const url = new URL('https://api.okdata.online/v1/xiaohongshu/pgy/notes/trending'); const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.OKDATA_API_KEY}`, }, }); const body = await res.json(); if (body.code !== 'ok') throw new Error(`${body.code}: ${body.message}`); for (const row of body.data.items) { console.log(row.id, row.metrics.likes, row.text.slice(0, 60)); } console.log('cost: $' + body.meta.billing.amount); ``` ### MCP ```json { "name": "call", "arguments": { "capability": "xiaohongshu.pgy.notes.trending" } } ``` Or ask an agent that has the MCP server connected: > Use Xiaohongshu PGY trending notes and list the five posts with the most likes, with links. ## Response example ```json { "code": "ok", "request_id": "0f6c2a8e-4b1d-4e0a-9a51-3c7d2b9e1f20", "data": { "items": [ { "id": "6731f0a2000000001b02c3d4", "url": "https://www.xiaohongshu.com/explore/6731f0a2000000001b02c3d4", "type": "image", "title": "油皮夏天防晒怎么选｜实测 6 款", "text": "连续两周通勤实测，按清爽度和防晒力排了个序，第 3 款意外好用。", "lang": "zh", "published_at": "2026-11-02T09:30:00Z", "author": { "id": "5f1234567890abcdef123456", "username": null, "name": "通勤护肤笔记", "avatar_url": "https://cdn.example.com/avatar/trailkit.jpg", "followers": 46200, "verified": true }, "metrics": { "views": null, "likes": 48200, "comments": 1312, "shares": 2210, "favorites": 9650, "reposts": null }, "images": [ "https://sns-img.example.com/6731f0a2/1.jpg", "https://sns-img.example.com/6731f0a2/2.jpg" ], "hashtags": [ "防晒", "油皮" ] } ] }, "page": { "next_cursor": "eyJvIjoyMH0", "has_more": true }, "warnings": [], "meta": { "capability": "xiaohongshu.pgy.notes.trending", "billing": { "amount": "0.04", "currency": "USD", "balance_after": "9.96" }, "unavailable": { "metrics.views": "platform", "metrics.reposts": "platform" }, "cached": false, "replayed": false, "fetched_at": "2026-11-11T08:00:00Z" } } ``` ## Errors Errors share one shape: code, request_id, message and message_zh (a fixed sentence per code), charged, retry, retry_after_seconds, param and docs_url, with the specifics in problems. They are not charged; only settlement_unknown is unknown until looked up. The full table: https://okdata.online/docs/errors/ ## Questions ### How much does the Xiaohongshu PGY trending notes API cost? One call costs $0.04 and returns one page of about 34 notes. Collecting 1,000 notes takes about 30 calls, $1.20 in total. Each page is a separate call; failed calls are not charged. ### How do I get the next page? Pass page.next_cursor from the response back as the cursor parameter. When page.has_more is false there is nothing left. Every page is its own call at $0.04. ### Do I need a Xiaohongshu (RedNote) account, cookies or a QR login? No. You send only your okdata API key. The data is public data from Xiaohongshu (RedNote); nothing is fetched with your own Xiaohongshu (RedNote) account. ### Am I charged when a call fails? No. Every error response says charged: false, except a timeout, which says charged: null until the outcome is known. Resend with the same Idempotency-Key and you are never charged twice. ### What if Xiaohongshu (RedNote) does not show a field? The field is null, and meta.unavailable names it with the reason: platform (the platform never shows it) or capability (we cannot fetch it yet). ## More Xiaohongshu (RedNote) endpoints - [Xiaohongshu note search](https://okdata.online/apis/xiaohongshu/notes/search/): $0.02 per call · about 20 notes per page - [Xiaohongshu note detail](https://okdata.online/apis/xiaohongshu/notes/get/): $0.02 per call - [Xiaohongshu note comments](https://okdata.online/apis/xiaohongshu/notes/comments/list/): $0.02 per call · about 10 comments per page - [Xiaohongshu account profile](https://okdata.online/apis/xiaohongshu/users/get/): $0.02 per call - [Xiaohongshu account notes](https://okdata.online/apis/xiaohongshu/users/notes/list/): $0.02 per call · about 20 notes per page - [Xiaohongshu hot topics](https://okdata.online/apis/xiaohongshu/trends/list/): $0.02 per call · about 20 board entries per page - [Xiaohongshu PGY creator search](https://okdata.online/apis/xiaohongshu/pgy/creators/search/): $0.04 per call · about 20 creators per page - [Xiaohongshu PGY creator detail](https://okdata.online/apis/xiaohongshu/pgy/creators/get/): $0.04 per call - [Xiaohongshu shop product search](https://okdata.online/apis/xiaohongshu/shop/products/search/): $0.02 per call · about 20 products per page - [Xiaohongshu shop product reviews](https://okdata.online/apis/xiaohongshu/shop/products/reviews/list/): $0.02 per call · about 12 reviews per page - [Xiaohongshu image search](https://okdata.online/apis/xiaohongshu/images/search/): $0.02 per call · about 20 posts per page - [Xiaohongshu comment replies](https://okdata.online/apis/xiaohongshu/comments/replies/list/): $0.02 per call · about 5 comments per page - [Xiaohongshu topic notes](https://okdata.online/apis/xiaohongshu/topics/notes/list/): $0.02 per call · about 10 notes per page - [Xiaohongshu topic detail](https://okdata.online/apis/xiaohongshu/topics/get/): $0.02 per call - [Xiaohongshu account search](https://okdata.online/apis/xiaohongshu/users/search/): $0.02 per call · about 20 accounts per page - [Xiaohongshu shop product detail](https://okdata.online/apis/xiaohongshu/shop/products/get/): $0.02 per call - [Xiaohongshu search suggestions](https://okdata.online/apis/xiaohongshu/keywords/related/): $0.02 per call · about 10 results per page - [Xiaohongshu video note with its video](https://okdata.online/apis/xiaohongshu/videos/get/): $0.02 per call - [Xiaohongshu PGY keyword search index](https://okdata.online/apis/xiaohongshu/pgy/keywords/history/): $0.04 per call - [Xiaohongshu PGY related keywords](https://okdata.online/apis/xiaohongshu/pgy/keywords/related/): $0.04 per call · about 98 results per page - [Xiaohongshu PGY creator audience](https://okdata.online/apis/xiaohongshu/pgy/creators/audience/get/): $0.04 per call - [Xiaohongshu PGY creator note metrics](https://okdata.online/apis/xiaohongshu/pgy/creators/metrics/): $0.04 per call - [Xiaohongshu PGY creator notes](https://okdata.online/apis/xiaohongshu/pgy/creators/notes/list/): $0.04 per call · about 8 notes per page - [Xiaohongshu PGY creator follower history](https://okdata.online/apis/xiaohongshu/pgy/creators/followers/history/): $0.04 per call - [Xiaohongshu PGY similar creators](https://okdata.online/apis/xiaohongshu/pgy/creators/related/): $0.04 per call · about 4 creators per page - [Xiaohongshu PGY creator costs and summary](https://okdata.online/apis/xiaohongshu/pgy/creators/costs/metrics/): $0.04 per call - [Xiaohongshu PGY creator follower quality](https://okdata.online/apis/xiaohongshu/pgy/creators/followers/metrics/): $0.04 per call - [Xiaohongshu PGY creator core figures history](https://okdata.online/apis/xiaohongshu/pgy/creators/costs/history/): $0.04 per call - [Xiaohongshu PGY note figures](https://okdata.online/apis/xiaohongshu/pgy/notes/get/): $0.04 per call ## At a glance - **Short name**: Xiaohongshu PGY trending notes - **Also called**: rednote viral notes, xhs content square - **Category**: [Social media](https://okdata.online/categories/social/) - **Group**: [Xiaohongshu PGY API](https://okdata.online/apis/xiaohongshu/pgy/) - **Data type**: [Trending posts API](https://okdata.online/roles/posts-trending/) - **Status**: preview. It may still change; any change is announced beforehand. - **Price**: $0.04 per call · failed calls are free - **Returns**: About 34 notes a page, with a cursor for the next page - **If a call fails**: Not charged. When a data source fails, the next one is tried; errors and timeouts cost nothing. ## When it is charged - Data comes back: $0.04 per call - Bad parameters, errors, timeouts: Free | When | Charge | |---|---| | Each further page | A new call: $0.04 | | Most one call costs | $0.04 | | An empty answer | $0.04 | | Bad parameters, errors, timeouts | Free | | A retry with the same Idempotency-Key within 24 hours | Charged once | A failed call is free; an empty answer costs $0.04; not found is free. Prices from price book 1b273c48fea9634e. [Every price on this platform](https://okdata.online/pricing/xiaohongshu/) - New accounts get $0.10 of credit, no card needed: 2 calls to this endpoint. - About 30 calls fetch 1,000 notes: $1.20 in all. ## Known limits - About 34 notes come back per page; the platform sets the page size, so there is no page-size parameter. - For the next page, pass `page.next_cursor` back as `cursor`. A cursor stays valid for 24 hours. When `page.has_more` is false there is nothing left. ## Fields by view The view column is the smallest `view` a field comes back in: `compact` returns only compact fields, `standard` adds the standard ones, `full` returns everything. The default is `standard`. - `compact`: `id`, `url`, `type`, `title`, `text`, `published_at`, `author`, `metrics` - `standard`: `lang`, `images`, `hashtags` - `full`: `ext` ## What this endpoint cannot give - `metrics.views`: the platform does not show it (null, listed in meta.unavailable) - `metrics.reposts`: the platform does not show it (null, listed in meta.unavailable) ## Common errors on this endpoint | HTTP | Code | Meaning | Charged | Retry | |---|---|---|---|---| | 400 | `invalid_params` | A parameter is missing, has the wrong type or value, or the method is wrong. problems lists each one; param names the first. | no | after a fix | | 400 | `cursor_mismatch` | The cursor was sent to another endpoint, or with other parameters than the page it came from (view and fields may change). | no | after a fix | | 401 | `unauthorized` | The key is missing, malformed, revoked, disabled or expired (reason says which when known). | no | no | | 402 | `insufficient_balance` | The balance (available) cannot cover the most this call could cost (required). | no | after a fix | | 410 | `cursor_expired` | The cursor is older than the endpoint's cursor lifetime (page.cursor_expires_at said when). | no | no | | 429 | `rate_limited` | The account sent too many requests this minute (reason: rate) or has too many calls running (reason: concurrency). | no | yes | | 500 | `settlement_unknown` | The data came back, but the charge could not be confirmed. | unknown until looked up | with the same Idempotency-Key | | 502 | `upstream_failed` | Every data source for this endpoint failed on this request. | no | yes | | 503 | `capability_paused` | This endpoint is paused right now; nothing ran. | no | yes | | 504 | `timeout` | The data did not come back in time. The hold was released, so nothing was charged. | no | yes | [All error codes](https://okdata.online/docs/errors/) ## Presets - [Xiaohongshu PGY trending notes: board hot](https://okdata.online/apis/xiaohongshu/pgy/notes/trending/hot/) - [Xiaohongshu PGY trending notes: board seeding](https://okdata.online/apis/xiaohongshu/pgy/notes/trending/seeding/) - [Xiaohongshu PGY trending notes: board shop_promo](https://okdata.online/apis/xiaohongshu/pgy/notes/trending/shop_promo/) - [Xiaohongshu PGY trending notes: board pgy](https://okdata.online/apis/xiaohongshu/pgy/notes/trending/pgy/) - [Xiaohongshu PGY trending notes: board leads](https://okdata.online/apis/xiaohongshu/pgy/notes/trending/leads/) - [Xiaohongshu PGY trending notes: board shop_hot](https://okdata.online/apis/xiaohongshu/pgy/notes/trending/shop_hot/) - [Xiaohongshu PGY trending notes: board direct_seeding](https://okdata.online/apis/xiaohongshu/pgy/notes/trending/direct_seeding/) - [Xiaohongshu PGY trending notes: board app_promo](https://okdata.online/apis/xiaohongshu/pgy/notes/trending/app_promo/) ## Same data on other platforms - [Reddit Popular feed](https://okdata.online/apis/reddit/popular/posts/list/): $0.002 per call · about 10 posts per page - [Douyin video boards](https://okdata.online/apis/douyin/videos/trending/): $0.002 per call · about 9 videos per page - [Bilibili popular videos](https://okdata.online/apis/bilibili/videos/trending/): $0.002 per call · about 20 videos per page [Trending posts API](https://okdata.online/roles/posts-trending/) ## Use it in your AI > Read https://okdata.online/apis/xiaohongshu/pgy/notes/trending.md, then call this endpoint for me through okdata; my key is in the OKDATA_API_KEY environment variable. Use Xiaohongshu PGY trending notes and list the five posts with the most likes, with links. ## Xiaohongshu (RedNote) endpoints by group - [Xiaohongshu PGY API](https://okdata.online/apis/xiaohongshu/pgy/): Xiaohongshu PGY creator search $0.04, Xiaohongshu PGY creator detail $0.04, Xiaohongshu PGY keyword search index $0.04, Xiaohongshu PGY related keywords $0.04, Xiaohongshu PGY creator audience $0.04, Xiaohongshu PGY creator note metrics $0.04, Xiaohongshu PGY creator notes $0.04, Xiaohongshu PGY creator follower history $0.04, Xiaohongshu PGY similar creators $0.04, Xiaohongshu PGY creator costs and summary $0.04, Xiaohongshu PGY creator follower quality $0.04, Xiaohongshu PGY creator core figures history $0.04, Xiaohongshu PGY note figures $0.04 - [Xiaohongshu Shop API](https://okdata.online/apis/xiaohongshu/shop/): Xiaohongshu shop product search $0.02, Xiaohongshu shop product reviews $0.02, Xiaohongshu shop product detail $0.02