RedNote (Xiaohongshu) Keyword Note Search API

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:

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.