Rnote API Rnote API
Back to Blog

RedNote (Xiaohongshu) Keyword Note Search API

Rnote API Team · · 80 views · 中文
Xiaohongshu Data Keyword Search Notes

Keyword search is the main entry point for any RedNote (Xiaohongshu) data workflow — whether you're sourcing products, chasing trends, or monitoring competitors, step one is usually "pull the relevant notes for a keyword." The Rnote API search endpoint lets you fetch paginated lists of related notes from a single keyword, with sorting by relevance, recency, likes, and more.

What keyword search unlocks

  • Product & trend discovery — Search a category ("camping gear", "affordable makeup"), sort by likes, and instantly surface today's hottest notes and selling points.
  • Competitor monitoring — Search a brand or product name to track note volume and engagement over time.
  • Content ideas — Analyze the titles and structure of top-performing notes for a topic to guide your own posts.
  • Reputation tracking — Periodically search your brand keyword to catch negative or risky content early.

The endpoint

GET /api/v2/crawler/search/notes

Common query parameters:

Parameter Description
keyword Search term (required), e.g. 美食推荐
page Page number, starting at 1
sort_type general / time_descending (newest) / popularity_descending (most liked) / comment_descending / collect_descending
note_type 不限 (any) / 视频笔记 (video) / 普通笔记 (image) / 直播笔记 (live)
time_filter 不限 (any) / 一天内 (last day) / 一周内 (last week) / 半年内 (last 6 months)

Python example

import requests

API_BASE = "https://rnote.dev/api/v2/crawler"
HEADERS = {"X-API-Key": "YOUR_API_KEY"}

resp = requests.get(
    f"{API_BASE}/search/notes",
    params={
        "keyword": "camping gear",
        "page": 1,
        "sort_type": "popularity_descending",  # sort by likes
    },
    headers=HEADERS,
)
results = resp.json()
# Iterate results, grab each note_id, then call the image/video endpoint for details

Once you have a note_id, call the watermark-free image/video endpoint to fetch the full note.

Pagination & dedup tips

  • When paging, pass the search_id / search_session_id returned by the first search into subsequent requests to keep pagination consistent.
  • Deduplicate by note_id across pages to avoid repeats under different sort orders.
  • Since only successful requests are billed, you can safely retry failed requests at no extra cost.

FAQ

Q: How many pages can I fetch? A: Keep incrementing page. Combine time_filter and sorting to focus on the range you care about — it saves credits and improves precision.

Q: Can I search creators and products too? A: Yes. Besides search/notes, there are search/users and search/products endpoints — see the API docs.

Get started

Sign up free for an API key, read the docs and pricing, and run your first search in minutes.

Back to Blog