Rednote Public Data APIs
Retrieve public profiles and notes, search notes or users, collect comments and nested replies, and capture one home recommendation page.
Available Rednote APIs
Choose from eight APIs for profile, note, comment, reply, search, and recommendation workflows.
rednote/comment-replies
Comments1 credit / request
rednote/home-recommendations
Posts1 credit / request
rednote/note-comments
Comments1 credit / request
rednote/note-detail
Posts1 credit / request
rednote/search-notes
Search1 credit / request
rednote/search-users
Search1 credit / request
rednote/user-notes
Posts1 credit / request
rednote/user-profile
Profiles1 credit / request
What Rednote data can you retrieve?
The Rednote catalog returns normalized account, post, and comment records from public source data.
Profiles and user notes
Resolve one public profile or collect one source page of notes using a supported account URL or user_id.
Note details and discovery
Retrieve one token-bearing note URL, search notes with supported filters, or collect a home recommendation page.
User search
Search the fixed first source page of public accounts with one non-empty query.
Comments and replies
Collect one public comment page for a note or one reply page for a known comment ID.
Rednote API contracts at a glance
Each endpoint has a bounded source request and rejects undeclared parameters.
| API group | Starting input | Source boundary |
|---|---|---|
| Profile and user notes | url or user_id | One profile or one source page; no results_limit |
| Note detail | Supported URL with note path and xsec_token | At most one note record |
| Search | Non-empty query and supported optional enums | Fixed first source page; no results_limit |
| Comments and replies | Supported note URL; replies also require comment_id | One source response page |
| Home recommendations | All fields optional | One page with results_limit 1–40, default 20 |
How the Rednote APIs work
All eight endpoints use the same asynchronous submit, poll, and stored-result workflow.
1. Choose the endpoint
Select the profile, note, search, comment, reply, or recommendation endpoint for your public-data task.
2. Submit valid input
POST only the declared fields and save the returned task_id.
3. Read normalized results
Poll the task to a terminal state, then read data.results.items and use next_cursor only for stored-result pagination.
Authenticate with a SocQ API key and submit a query with supported optional filters. Each successful Rednote task costs a fixed 1 credit.
curl -X POST "https://api.socq.ai/v1/rednote/search-notes" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"travel guide","sort_by":"general","media_type":"all"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successCommon Rednote API use cases
Creator and content research
Combine public account identity with a bounded page of authored notes.
Topic discovery
Compare note search, user search, and home recommendation snapshots with collection timestamps.
Conversation review
Inspect a public note's comments and a selected comment's nested replies as normalized records.
Limits and public-data policy
These endpoints read public data through bounded source requests and do not provide account actions or private access.
- Supported URL hosts are xiaohongshu.com, xhslink.com, and their subdomains; Note Detail additionally requires an /explore/{id} or /discovery/item/{id} path and a non-empty xsec_token.
- user_id and comment_id accept 1–256 ASCII letters, numbers, colons, underscores, or hyphens.
- Search Notes accepts sort_by, media_type, and published_within only from the listed enum values; Search Users accepts query only.
- Only Home Recommendations accepts results_limit, with a range of 1–40 and a default of 20.
- Every successful Rednote task costs a fixed 1 credit.
Rednote API frequently asked questions
What are the Rednote APIs?
The Rednote APIs retrieve public profiles, notes, comments, nested replies, search results, and home recommendations as normalized records.
Which endpoint accepts results_limit?
Only Home Recommendations accepts results_limit, as an integer from 1 to 40. The other Rednote endpoints reject it.
Does Note Detail accept any Rednote URL?
No. It requires an accepted host, an /explore/{id} or /discovery/item/{id} path, and a non-empty xsec_token query value.
How are Rednote requests priced?
Each successful task costs a fixed 1 SocQ credit.
Combine data across platforms for more complete business insights
Bring public profiles, content, and engagement data from different platforms into one workflow to track brands, creators, and topics and run cross-platform monitoring and analysis more efficiently.
Pinterest API
Retrieve public Pinterest profile data, resolve known Pins, collect Pins from selected profiles, or search by keyword for creator, content, and visual trend research.
Threads API
Retrieve public Threads profiles, resolve known posts, or collect posts from selected profiles with normalized identity, content, media, engagement, and timestamp fields.
Bluesky API
Retrieve public Bluesky profiles, resolve known post URLs, or collect one page of account posts with normalized identity, content, media, timestamps, and visible engagement fields.
Snapchat API
Retrieve a known public Snapchat Spotlight as a normalized record with available creator, caption, media, audio, timestamp, duration, and engagement fields.
Twitch API
Resolve a known public Twitch username into a normalized profile or collect its public video inventory for creator research, catalog enrichment, comparison, and snapshot monitoring.
Apple App Store API
Collect public Apple App Store app details, category rankings, and reviews from known store URLs as normalized app and review records.