Xiaohongshu note search API

Search notes

GET/v1/xiaohongshu/notes/search

Use the Xiaohongshu note search API to read public Xiaohongshu notes. Search notes

Request

Send your API key as a Bearer token. Replace YOUR_API_KEY with a key from your console.

curl "https://xtikapi.com/v1/xiaohongshu/notes/search?keyword=city" \
  -H "Authorization: Bearer YOUR_API_KEY"

Parameters

NameTypeRequired
keywordstringrequired
cursornumberoptional
sortstringoptional
note_typestringoptional
time_filterstringoptional
search_idstringoptional
search_session_idstringoptional
sourcestringoptional
ai_modenumberoptional

Response fields

Every platform returns the same post shape. A field the platform does not provide is named in meta.unavailable.

  • id
  • url
  • text
  • author
  • createdAt
  • likeCount
  • commentCount
  • shareCount
  • viewCount
  • cover

Example response

Recorded from a live call on 2026-11-18. Names, text, links and images are replaced with examples; counts, dates and field names are real.

{
  "data": {
    "items": [
      {
        "id": "3xxx1852963074185x96x0xx",
        "text": "Example text",
        "author": {
          "id": "3xx418xx96xx741x52x63x7x",
          "username": "example_user",
          "name": "Example name",
          "avatar": "https://example.com/image.jpg"
        },
        "createdAt": "2026-09-20T07:55:20.000Z",
        "likeCount": 4345,
        "commentCount": 509,
        "cover": "https://example.com/image.jpg",
        "url": "https://example.com/link"
      },
      {
        "id": "3xxx18x2963074185296xx7x",
        "text": "Example text",
        "author": {
          "id": "307xxxxx96x0x418xx9xxx74",
          "username": "example_user",
          "name": "Example name",
          "avatar": "https://example.com/image.jpg"
        },
        "createdAt": "2026-10-10T13:55:53.000Z",
        "likeCount": 55,
        "commentCount": 12,
        "cover": "https://example.com/image.jpg",
        "url": "https://example.com/link"
      }
    ]
  },
  "meta": {
    "request_id": "example",
    "endpoint": "xiaohongshu.notes.search",
    "normalized": true,
    "unavailable": [
      "shareCount",
      "viewCount"
    ],
    "billing": {
      "charged": true,
      "amount": 0.02,
      "balance": 4.98
    }
  }
}

Error codes

Errors are not billed. Retry the ones marked yes. More in the API quickstart.

CodeHTTPRetryMeaning
unauthorized401noAPI key is missing, invalid, or revoked.
rate_limited429yesToo many requests.
invalid_params422noRequest parameters are invalid.
price_exceeds_max402noThis call costs more than X-Max-Price.
insufficient_balance402noBalance is too low for this call.
key_limit_reached402noThis API key has reached its spend limit.
idempotency_conflict409noThis Idempotency-Key was already used with different parameters.
idempotency_in_progress409yesA request with this Idempotency-Key is still running.
response_too_large409noThe response is too large to store for a safe retry.
upstream_error502yesThe data provider returned an error. You were not charged.
upstream_timeout504yesThe data provider timed out. You were not charged.
internal_error500yesSomething went wrong on our side. You were not charged.
not_found404noNo such endpoint.

Questions this API answers

More Xiaohongshu APIs

Questions

What does the Xiaohongshu note search API return?

A post object with the fields listed on this page. Missing provider fields are named in meta.unavailable.

When is the Xiaohongshu note search API billed?

This call costs $0.02 when the provider returns HTTP 200. An empty result is billed. Errors and timeouts are not billed.

What do I do if the provider returns an error?

The response has charged set to false. Read the error code and retry if the error says retry is true. Your balance is unchanged.

Where is this resource on another platform?

Use the links on this page for the same resource and action on other platforms. Change the platform word in the path.