Skip to content
All Xiaohongshu APIs
Trends & rankingsXiaohongshuCreator Hot Inspiration · List

Xiaohongshu hot inspiration

Read current public hot-inspiration topics and score snapshots.

POST/v1/xiaohongshu/creator-inspiration/hot

Chinese name: 小红书热点创作灵感 · 热门创作灵感 · 列表 分页读取创作者中心当前公开热点灵感及热度快照。
xiaohongshu.creator.inspiration.hot@v1

Price per call

¥0.19/ call

Complete and confirmed empty results are charged; partial results and failures are not.

Current statusAvailableChecking live status
Checking live status

Try it

Sign in and run one real call. The result and charge appear right here.

Security check

Loading the security check…

Checking live execution status…

Execution result

// Result

Request parameters

cursorstringoptional

minLength: 1

Request JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false
}

Code samples

Install the SDK with npm i @dataxapi/sdk or pip install dataxapi, and put your API key in the DATAXAPI_API_KEY environment variable.

curl -X POST https://api.dataxapi.com/v1/xiaohongshu/creator-inspiration/hot \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'

Response example

200 · application/json
{
  "code": 200,
  "request_id": "req_example_xhs_batch_4",
  "message": "success",
  "data": {
    "items": [
      {
        "id": "57867632",
        "hot_id": "hot-001",
        "title": "秋日露营",
        "kind": "热词",
        "score": 24486335,
        "score_text": "2448.6 万热度",
        "cover_url": "https://ci.xiaohongshu.com/public-hot-cover"
      }
    ]
  },
  "page": {
    "next_cursor": "opaque_cursor"
  },
  "warnings": [],
  "meta": {
    "listing_id": "xiaohongshu.creator.inspiration.hot",
    "version": "v1",
    "catalog_release_id": "catalog-production-2026-09-19.b069be57",
    "price_book_version": "pricebook-production-2026-09-19.4487e352",
    "result_status": "complete",
    "charged_amount": "0.19",
    "balance_after": "49.81",
    "currency": "CNY"
  }
}
Response fields
codenumber
const: 200
request_idstring
messagestring
const: "success"
dataobject
pageobject
warningsarray
metaobject
Response JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "code": {
      "type": "number",
      "const": 200
    },
    "request_id": {
      "type": "string"
    },
    "message": {
      "type": "string",
      "const": "success"
    },
    "data": {
      "type": "object",
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "hot_id": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "title": {
                "type": "string"
              },
              "kind": {
                "type": "string"
              },
              "score": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "score_text": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "cover_url": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uri"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "id",
              "hot_id",
              "title",
              "kind",
              "score",
              "score_text",
              "cover_url"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "items"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "next_cursor"
      ],
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "const": "xiaohongshu.creator.inspiration.hot"
        },
        "version": {
          "type": "string",
          "const": "v1"
        },
        "catalog_release_id": {
          "type": "string",
          "minLength": 1
        },
        "price_book_version": {
          "type": "string",
          "minLength": 1
        },
        "result_status": {
          "type": "string",
          "enum": [
            "complete",
            "empty",
            "partial"
          ]
        },
        "charged_amount": {
          "type": "string"
        },
        "balance_after": {
          "type": "string"
        },
        "currency": {
          "type": "string",
          "const": "CNY"
        }
      },
      "required": [
        "listing_id",
        "version",
        "catalog_release_id",
        "price_book_version",
        "result_status",
        "charged_amount",
        "balance_after",
        "currency"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "code",
    "request_id",
    "message",
    "data",
    "page",
    "warnings",
    "meta"
  ],
  "additionalProperties": false
}

Usage notes

Good for

  • Use it to inspect public hot creation themes now.

Not for

  • Do not use it to publish, prove causality, or predict future traffic.

Known limitations

  • The observed first page returned 20 items; scores are point-in-time snapshots.
  • Order and recall are not stable or exhaustive guarantees.
  • Publishing and detail deeplinks, tokens, and debug fields are excluded.

Billing

¥0.19 per call. Complete and confirmed empty results are charged; partial results and failures are not.

See all pricing →