# Xiaohongshu Details API (xiaohongshu.profile)

- Canonical page: https://everyinfra.com/en/xiaohongshu-api/profile
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "xiaohongshu", "action": "profile", "params": {...}}
- Price: $0.005556 per call ($5.56 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

Xiaohongshu Details reads one account's profile, given its `user_id`: nickname, Xiaohongshu ID, bio, avatar, gender, IP location, verification, follower and following counts, post count, and the likes and saves its notes have received. It tells brand teams, agencies and researchers how large and how engaged an account is before they shortlist a creator, sign a partnership or add the account to a tracking list.

Pass the ID that follows /user/profile/ in a profile link, the link itself, or a commenter's author ID from Xiaohongshu Comments results. `follower_count` is exact here, unlike the rounded figures in User search, and counts come back null rather than zero when they are not public. `ip_location` is the province or country the platform attaches to the account, not something the owner fills in, and `real_name_info` appears only when the profile shows real-name details.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=xiaohongshu&action=profile

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| user_id | not declared | yes | not declared | Specifies the Xiaohongshu user ID (the identifier following /user/profile/ in the URL) or full profile URL for the profile and user_posts actions. The author_id returned by the comment actions also works. Used to fetch profile details or published notes; does not accept username display names. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| user_id | User's unique ID on the platform. |
| nickname | Display name of the account. |
| red_id | Xiaohongshu ID: the searchable ID the account holder chooses, different from the internal user_id. |
| url | The record's link on Xiaohongshu. Links from search, note, profile and hashtag usually carry an access token, so they open in a signed-out browser (the token expires; call again for a fresh link). Note links from user_posts carry no token and need one to open in a browser: call note with the note ID to get a link that opens. Profile links from search_users carry no token either; call profile with the user_id for one that opens. Note links from pgy_content_square carry a token, except with `keyword`, where they carry none. |
| bio | Profile bio written by the account; may contain line breaks and emoji. |
| follower_count | Follower count. Exact on profile. Approximate on search_users: the list shows a rounded figure (12,000 appears as 1.2 × 10,000), converted to a whole number. null means not public or not recognized, not zero. |
| following_count | Accounts followed. null means not disclosed, not 0. |
| like_collect_count | The profile's likes-and-saves total: likes received plus saves across the account's notes. like_count and collect_count give the two parts. |
| post_count | Total posts. null means not disclosed, not 0. |
| gender | Gender as shown on the profile; may be empty. |
| ip_location | IP location (province or country) that Xiaohongshu displays; not entered by the user. Only some user_posts rows carry it. |
| avatar_url | Avatar image link. Some platforms return sized CDN links that can expire. |
| is_verified | Whether the platform verified the account. null means it cannot be determined. |
| tags | Tag list: on note, the note's topic tags; on profile, the personal tags shown on the profile page (such as star sign or region); on reviews, the review tags the store attaches, such as good quality, absent when there are none. As written. |
| like_count | Like count. On note and comment results, the likes on that item; on profile, the total likes the account's notes have received. null means not public or not returned this time, not zero. |
| collect_count | Save count. On note results, how many times that note was saved; on profile, the total saves across the account's notes. null means not public or not returned this time, not zero. |
| real_name_info | Real-name details exactly as the profile shows them; the field is absent when there are none. |
| verification_type | Verification type on search_users and profile: individual (verified person), business (verified business) or other. Unverified accounts leave this field out. |
| verification_text | Verification description as written on the profile (profile). |
| location | Location description passed through as is; the format varies by platform. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "xiaohongshu",
  "action": "profile",
  "params": {
    "user_id": "5bec178863f51f0001859bd9"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "xiaohongshu",
        "action": "profile",
        "params": {
            "user_id": "5bec178863f51f0001859bd9",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-10-24T18:28:34Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "xiaohongshu",
  "action": "profile",
  "results": {
    "user_id": "5bec178863f51f0001859bd9",
    "nickname": "•••",
    "red_id": "536248807",
    "url": "https://www.xiaohongshu.com/user/profile/5bec178863f51f0001859bd9?xsec_token=YBa43WesDF2ZG-HMGXVxTlt0t4eJdIhAYkDoVSOA1K-Ew%3D",
    "bio": "人生的觉醒消失于人群之中",
    "follower_count": 2114,
    "following_count": 49,
    "like_collect_count": 16889,
    "post_count": 752,
    "gender": 0,
    "ip_location": "•••",
    "avatar_url": "https://sns-avatar-qc-ae.rednotecdn.com/•••",
    "is_verified": false,
    "tags": [
      "白羊座",
      "江苏扬州",
      "旅行博主"
    ],
    "like_count": 15178,
    "collect_count": 1711,
    "location": "中国  江苏  扬州",
    "platform": "xiaohongshu"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### What does `like_collect_count` measure?

The likes-and-saves total shown on the profile: every like plus every save the account's notes have received. `like_count` and `collect_count` give the two parts separately, so you can see whether an audience mostly likes an account's notes or saves them to come back to.

### Should I store `user_id` or `red_id`?

Store both, but key your records on `user_id`, which is what you pass back to this capability and to Posts by user. `red_id` is chosen by the account holder and is what people type into the app's search, so it is handy for display and for matching an ID someone sends you.

### Does the profile link open in a browser?

Usually, yes. Links from this capability normally carry an access token, so they open without signing in until the token expires; calling again returns a fresh one. Profile links from User search and note links from Posts by user lack the token, which is why those capabilities point you here or to Note details.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=xiaohongshu
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md