# Xiaohongshu Profile API (https://www.socialcrawl.dev/platforms/xiaohongshu/profile)

> Returns one Xiaohongshu creator: display name, RedNote id (author.username), bio, avatar, followers, following, notes posted, likes received and the IP province. Accepts a profile URL or the user id carried on a note as post.ext.author_id. The RedNote id is not a lookup key. For the creator's notes call GET /v1/xiaohongshu/profile/posts.

TL;DR: `GET /v1/xiaohongshu/profile` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | no | Xiaohongshu profile URL, for example https://www.xiaohongshu.com/user/profile/6a59f257000000000f03b000. |
| `id` | no | User id, the author_user_id on a note. Not the RedNote id. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/xiaohongshu/profile" \
  --data-urlencode "url=https://www.xiaohongshu.com/user/profile/6a59f257000000000f03b000" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a Xiaohongshu user profile with an API?

Call GET /v1/xiaohongshu/profile with either url (a profile URL such as https://www.xiaohongshu.com/user/profile/6a59f257000000000f03b000) or id (the user id). You send one of the two, and the response is the creator as unified JSON.

### What does the Xiaohongshu profile endpoint return?

It returns the display name, the RedNote id in author.username, bio, avatar, followers, following, notes posted, likes received and the IP province. It does not list the creator's notes, which come from GET /v1/xiaohongshu/profile/posts.

### Can I look up a Xiaohongshu profile by RedNote id?

No. The RedNote id is returned in the response but it is not a lookup key. Use the profile URL, or the user id that every note carries as post.ext.author_id (the author_user_id), which a note search returns.

### How much does a Xiaohongshu profile lookup cost?

A profile lookup is a flat charge of 5 credits on the advanced tier. Credits for failed or empty calls are refunded automatically, and there is no subscription. The 100 free credits on a new account cover 20 lookups.

### How do I find the user id for a Xiaohongshu creator?

Search notes with GET /v1/xiaohongshu/search and read the creator's user id from the note, then pass it as id to the profile endpoint. You can also paste the profile URL straight into url if you already have it.

### Is there a Xiaohongshu API for creator data without an official key?

SocialCrawl serves public Xiaohongshu creator data through one SocialCrawl API key, so you do not apply for access on the Xiaohongshu side. The profile response uses the same Author schema as the other platforms.

See the full Xiaohongshu API: https://www.socialcrawl.dev/platforms/xiaohongshu

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I get a Xiaohongshu user profile with the SocialCrawl API?
- Which API returns Xiaohongshu follower counts and creator bio data?
- What does the SocialCrawl /v1/xiaohongshu/profile endpoint return?