What you get
| Capabilities | Note search / Creator search / Creator details / Creator posts / Note details / Fetch comments |
|---|---|
| Response fields | Note url, text, author, created_at, likes, collects, comments, cover |
| Integration | MCP (Streamable HTTP) or REST (GET or POST) |
| Notes | Chinese platforms are authorized in groups. New accounts get 5 free calls on Chinese social platforms (no charge to your balance); access unlocks after a cumulative top-up of $30. Failed calls are refunded automatically. |
Response schema
Whichever platform you call, post-type responses share the same structure: items[] holds platform / id / url / author{id,handle,name} / text / created_at / stats{...} / cover; creator responses are handle / name / bio / followers / following / posts / verified / avatar / url. Switching platforms needs no changes to your parsing code.
MCP or REST
For models, use MCP: add https://lucydomi.com/mcp to your client config and it selects the tools itself. For code, use REST: https://lucydomi.com/mcp/v1/search_posts, where GET with query parameters or POST with a JSON body both work and return an identical structure.
Copy and run
curl -s https:
Sample response
This is a real production response, truncated to one item and with billing fields removed.
{ "ok": true, "platform": "xiaohongshu", "tool": "search_posts", "count": 1, "items": [ { "platform": "xiaohongshu", "id": "6a8a775e000000002901a04b", "url": "https:
FAQ
Do I need my own scraper or proxy?
No. Scraping and cleaning happen server-side, so you only receive structured JSON; failed calls are refunded automatically.Can I use it commercially?
Everything returned is publicly visible content and can be used for analysis and product features; see the “Data policy” page for the exact limits.Can I raise the number of results?
Yes, limit is adjustable, but each call returns synchronously. Fetch in batches to avoid a single call timing out.Related
One key, six platforms
Same fields, same MCP endpoint; switching platforms only changes one parameter. Sign up and get $0.2 in trial credit.
See pricing Try one call