# Xiaohongshu user profile API

user_profile on Xiaohongshu: 1.5 credits per successful call, with clear inputs, source data and billing.

Canonical: https://socialtoai.com/xiaohongshu-user-profile-api/

## One request

1.5 credits per successful or empty call. Failed calls cost 0.

Replace any PASTE_PUBLIC placeholder with a supported public identifier. This is a request template; it does not run automatically.

```
curl --request POST 'https://api.socialtoai.com/v1/user_profile' \
  --header "X-API-Key: $SOCIALTOAI_API_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: REPLACE_WITH_A_UNIQUE_REQUEST_ID' \
  --data '{"platform":"xiaohongshu","user":"PASTE_PUBLIC_ACCOUNT_ID"}'
```

## Native support

Result shape: profile_card. Pagination: not supported.

These values describe the reference card. Additional restrictions can apply to user discovery or a content subtype. Inspect applied_params and warnings instead of assuming an unsupported filter was honored.

## A schema-checked example

Illustrative result with one invented value and an example trial balance. It shows the response shape; it is not a live response or a production availability measurement.

```
{
  "request_id": "example_only_not_a_live_call",
  "schema_version": "v1",
  "fetched_at": "2026-09-05T00:00:00Z",
  "status": "ok",
  "applied_params": {},
  "warnings": [],
  "items": [
    {
      "kind": "profile_card",
      "id": "EXAMPLE_ACCOUNT_ID",
      "name": "Example account",
      "bio": "Illustrative profile, not a real account.",
      "followers": 12800,
      "posts_count": 214
    }
  ],
  "platform": "xiaohongshu",
  "billing": {
    "cost": 1.5,
    "balance": 0.5,
    "unit": "credits",
    "pricing": "standard"
  }
}
```

## Platform limitations

View counts are not exposed because the platform hides them. Missing metrics are not zero.

The 30d search filter falls back to all with a warning.

Product and commerce data are outside the six core verbs.

Share-link resolution is separate from the observed core supply evidence; prefer a stable public note URL or ID.

Native 1d/7d search filters can return older content. When returned dates are older than the requested window, that page reports time_range=all with a warning. Items are preserved and no extra search is made; missing dates remain unverifiable.

[All Xiaohongshu actions →](https://socialtoai.com/platforms/xiaohongshu/)