# Xiaohongshu (RED) PGY Blogger Notes API

> Returns notes posted by a specific blogger on the Xiaohongshu Pugongying platform. Supports filtering by note type, content tag, feature tag, and traffic source.

Source: https://www.sandbase.ai/model/xiaohongshu/pgy/blogger-notes
API reference: https://www.sandbase.ai/model/xiaohongshu/pgy/blogger-notes/docs

## Facts

- Provider: Xiaohongshu
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/xiaohongshu/pgy/blogger-notes`
- Price: $0.03 per call
- Capabilities: api, xiaohongshu
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/xiaohongshu/pgy/blogger-notes` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `user_id` | string | yes |  |
| `advertise_switch` | integer | no | 0, 1 |
| `note_type` | integer | no | 0, 1, 2, 4 |
| `order_type` | integer | no | 1, 2, 3 |
| `page_number` | integer | no |  |
| `page_size` | integer | no |  |
| `feature_tag` | string | no |  |
| `content_tag` | string | no |  |
| `is_third_platform` | integer | no | 0, 1 |

## FAQ

### How do I use the Xiaohongshu (RED) PGY Blogger Notes API?

Send a POST request to https://api.sandbase.ai/v1/api/xiaohongshu/pgy/blogger-notes with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Xiaohongshu (RED) PGY Blogger Notes API cost?

$0.03 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Xiaohongshu (RED) PGY Blogger Notes API accept?

Required: user_id (string). Optional: advertise_switch (one of 0, 1), note_type (one of 0, 1, 2, 4), order_type (one of 1, 2, 3), page_number (integer), page_size (integer) and feature_tag (string) and 2 more. The Parameters table and the Playground on this page list every field.

### What does the Xiaohongshu (RED) PGY Blogger Notes API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Xiaohongshu developer account or API key?

No. Xiaohongshu (RED) PGY Blogger Notes runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Xiaohongshu API access separately.

## README

### Xiaohongshu (RED) PGY Blogger Notes API

Retrieve notes for a specific creator by supplying their `user_id`. You can sort results by interaction or recency, and filter entries by tags and media formats.

#### Use cases

- Review historical content and top-performing posts for a specific creator.
- Filter creator posts by video or image formats to assess creative range.
- Analyze organic versus sponsored post performance across campaign categories.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/xiaohongshu/pgy/blogger-notes" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "<user_id>"}'
```

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `user_id` | string | Yes | Blogger user ID |
| `note_type` | integer | No | Note type, 0=all, 1=image, 2=video, 4=image+video |
| `page_size` | integer | No | Page size (1-100) |
| `order_type` | integer | No | Order, 1=most read, 2=most interaction, 3=latest |
| `content_tag` | string | No | 按内容类目筛选，如 美妆；取值见博主详情的 contentTags/Filter by content tag |
| `feature_tag` | string | No | 按内容特征筛选，如 韩系；取值见博主详情的 featureTags/Filter by feature tag |
| `page_number` | integer | No | Page number, start from 1 |
| `advertise_switch` | integer | No | Traffic type, 1=all (incl. ads), 0=organic only |
| `is_third_platform` | integer | No | 1=只看跨域合作笔记 0=不限(默认)/Cross-platform notes only |

#### Notes

- Use `order_type` to sort results by most read (1), most interaction (2), or latest (3).
- Pagination is controlled via `page_number` (starting at 1) and `page_size` (up to 100).
- Filter media formats using `note_type` with 0 for all, 1 for images, 2 for videos, or 4 for mixed.

#### Related APIs

- [Xiaohongshu (RED) Blogger Core Data](/model/xiaohongshu/pgy/blogger-core-data): Returns Pugongying core performance metrics and daily trend data for a specified Xiaohongshu blogger, filterable by date range, note type, and traffic source.
- [Xiaohongshu (RED) PGY Blogger Data Summary](/model/xiaohongshu/pgy/blogger-data-summary): Returns an account-level data summary for a Xiaohongshu blogger on the Pugongying (PGY) platform based on the specified blogger user ID.
- [Xiaohongshu (RED) PGY Blogger Details](/model/xiaohongshu/pgy/blogger-detail): Retrieves detailed profile information for a specific Xiaohongshu blogger on the PGY platform using their user ID.