FAQ
Frequently asked questions
Common questions about the RedNote data API — data sources, accounts, billing and more. Can't find your answer? Contact us.
Data & APIs
Where does the API data come from?
All Rnote API data comes in real time from RedNote's official mobile-app endpoints. Every call makes a genuine request to RedNote; on success it returns RedNote's raw JSON unchanged, with no edits and no third-party data — what you get is always the latest, real data.
Why is app data better than the web version?
RedNote's app endpoints return more complete fields than the web / H5 site — full note text, engagement metrics, multi-resolution video URLs, product and user details, and more. The web site heavily trims and restricts data for anti-abuse and performance reasons, so fields are often missing or compressed. Rnote API wraps the app endpoints, so completeness, field richness and stability clearly beat web-based approaches.
Is the data real-time or cached?
Real-time. Every request hits RedNote directly and returns the latest data; no stale cache is used.
Which data endpoints are available?
There are currently 22+ endpoints across six families: notes (image, video, comments), users, search, products, topics and creator insights. See the API docs for the full list and parameters.
Accounts & Usage
Do I need to provide my own RedNote account?
No. Rnote API has a built-in smart account pool that rotates, schedules and replenishes accounts automatically. You only need an API key — no need to provide, log in to or bind any RedNote account. Account risk control and maintenance are handled entirely by the platform.
What authentication does the API need?
Just send an
X-API-Key header. Create an API key in the admin panel — no OAuth, cookies or login session required.Which programming languages are supported?
Rnote API is a standard HTTP / RESTful API, so any language that can make HTTP requests works. The docs include sample code in cURL, Python, JavaScript, TypeScript, Java, Go and PHP.
Billing & Top-ups
Is billing in USD or RMB?
Pricing is in US dollars (USD); all endpoint prices are shown in USD. Billing is per request, each endpoint priced independently, with no monthly fee and no minimum spend. See the pricing page for full prices.
Does my account balance expire?
No. Topped-up balance is valid long-term — it never expires and is never reset, so you can use it any time.
Do new users get free credit?
Yes. After signing up and verifying your email you receive complimentary credit — try the endpoints right away and top up later as needed. Sign up free now.
Are failed or errored requests billed?
No. Only successful requests returning HTTP 2xx are billed. Network errors, 4xx and 5xx errors, parameter errors and the like are never charged.
How do I top up my account balance?
Contact an admin by email ([email protected]) or Telegram to arrange a top-up, or ask a reseller to transfer API credit to you. Balance is credited instantly; view your balance and usage in the admin panel. See Contact us for details.
Is there a request rate limit?
Yes. To maintain service quality, each API key has a request rate limit; exceeding it returns
HTTP 429. Reduce your concurrency and request rate, then retry.Still have questions?
Browse the full docs, or get in touch with our team.
No account yet? Sign up free — new accounts get complimentary credit.