Сценарий использования

API Xiaohongshu (RedNote), Douyin и Weibo для исследования рынка

Ищите заметки Xiaohongshu (RedNote), видео Douyin и посты Weibo по китайским ключевым словам и получайте JSON для исследований рынка. Оплата за результат.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
小红书抖音微博lovelyjsonitems[0]"title": "露营装备清单""author": "山野小林""likes": 12800"collects": 4310"comments": 562"tags": ["露营", "户外"]

Xiaohongshu (小红书, также RedNote или RED), Douyin и Weibo — это места, где китайские потребители находят товары, пишут на них отзывы и обсуждают бренды, в основном по-китайски. Lovely Router позволяет искать по всем трём площадкам одним вызовом API, словно у вас есть собственный API Douyin или Weibo: отправьте ключевое слово и получите заметки, видео и посты в виде JSON с оплатой за результат. Это сделано для брендов и агентств, которые исследуют китайский рынок, — неважно, готовите ли вы запуск из-за рубежа или отслеживаете конкурентов и KOL внутри страны.

Передайте это своему ИИ-агенту

Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.

Research Xiaohongshu (RedNote) notes, Douyin videos and Weibo posts for brand and market research. Search with Chinese keywords; translate what you report into my language. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the brand, product or topic and what you want to learn>
01

Как это работает

010203
  1. Выберите ключевые слова

    Ищите по словам, которыми пользуются ваши клиенты: 露营 (кемпинг), 咖啡 (кофе), категория товара или название бренда. Douyin и Weibo принимают также запросы на английском и названия брендов.

  2. Отправьте ключевое слово на POST /v1/tools/{id}/run с ограничением max_results. Запуск резервирует свою максимальную стоимость и возвращает результаты в виде JSON.

  3. Прочитайте, переведите, обобщите

    Результаты приходят на языке оригинала. Отправьте их модели с тем же ключом, чтобы перевести, кратко изложить или разметить их на английском.

02

Поиск заметок Xiaohongshu одним запросом

Поиск заметок Xiaohongshu выполняет одну операцию (operation) за вызов. search_notes возвращает заметки по ключевому слову; этот запуск запрашивает 20 заметок о кемпинге с наибольшим числом лайков:

curl https://lovelyrouter.com/v1/tools/xiaohongshu-search/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {"operation": "search_notes", "keyword": "露营", "sort_type": "like_count_descending"},
    "max_results": 20
  }'

Каждая заметка — это один элемент в items в собственном формате инструмента; сначала выполните небольшой поиск и посмотрите на поля, прежде чем строить на них что-то. Запуск, который не завершился за 60 секунд, возвращает 202; как опрашивать его, показано в разделе Запуск инструмента.

Douyin работает так же. Этот запуск возвращает до 50 видео о кофе с наибольшим числом лайков за последнюю неделю:

cURL
curl https://lovelyrouter.com/v1/tools/douyin-search/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"input": {"keywords": ["咖啡"], "sort": "most_liked", "publishTime": "one_week"}, "max_results": 50}'
03

Что возвращает каждый инструмент

Xiaohongshu (RedNote). xiaohongshu-search возвращает заметки по ключевому слову, если operation равно search_notes. sort_type упорядочивает их по general, time_descending или по наибольшему числу лайков, комментариев или сохранений (like_count_descending, comment_count_descending, collect_count_descending). В схеме входных данных перечислены и другие операции, среди них get_note_detail и get_note_comments (с note_id), get_user_info и list_user_notes (с user_id), а также search_products (с keyword); выберите одну и заполните только те поля, которые она использует. Описания полей даны на китайском и английском.

Douyin. Поиск видео в Douyin возвращает видео по одному или нескольким ключевым словам (keywords). Подходят китайский, английский, хештеги, названия брендов и эмодзи. Каждое ключевое слово ищется отдельно, а дубликаты между ними удаляются; реалистичное ключевое слово даёт несколько сотен уникальных видео. Сортируйте по general, most_liked или latest и ограничивайте publishTime значениями one_day, one_week или half_year.

Weibo. Поиск в Weibo выполняет одну операцию (operation) за вызов:

ОперацияВходные данныеЧто возвращает
searchWeibokeyword (на китайском, английском или вперемешку), maxPagesПосты по ключевому слову, около 14 на страницу
userDetailuserIdЧисло подписчиков, подписок и постов, причина верификации, местоположение, пол, описание профиля
userFans, userFollowersuserId, maxPagesСписок фанатов или подписчиков пользователя, около 20 пользователей на страницу

Числовой userId есть в URL профиля (weibo.com/u/{ID}) и в поле userId или user_id результатов поиска.

04

Рецепты

Проверьте идею товара до запуска

Запустите xiaohongshu-search с вашей категорией на китайском и "sort_type": "like_count_descending". Попросите модель перечислить на английском бренды, ценовые уровни и жалобы, которые встречаются в топовых заметках.

Найдите KOL в Weibo

Запустите searchWeibo с вашим брендом или категорией и "maxPages": 3, возьмите повторяющиеся значения userId и для каждого запустите userDetail, чтобы узнать число подписчиков и причину верификации.

Следите за трендом в Douyin

Каждую неделю запускайте douyin-search с "publishTime": "one_week" и "sort": "most_liked" по нескольким связанным ключевым словам и сравнивайте, какие видео лидируют каждую неделю.

Сравните Китай с остальным миром

Найдите ту же тему на английском через Поиск видео в TikTok с location, например "US", и сравните форматы и хуки с топовыми видео Douyin.

Закройте пробелы веб-поиском

Веб-поиск принимает оператор lang:zh, чтобы находить статьи и новости на китайском, по $0.0009 за поиск.

Персональные данные

Профили авторов и списки подписчиков во многих странах считаются персональными данными. Вы отвечаете за законное использование собранного, где бы ни находились вы и люди, о которых эти данные; см. Политику допустимого использования.

С подключённым MCP-сервером первый рецепт выполняется одним промптом: «Найди в Xiaohongshu 30 заметок про 露营 с наибольшим числом лайков, а в Weibo — посты про 露营装备, затем кратко изложи на английском, какие бренды и товары упоминают чаще всего. Задавай max_results в каждом запуске».

05

Сколько это стоит

Каждый запуск оплачивается за результат: заметку, видео или пост, а в Weibo ещё и за вызов; актуальные цены показаны на карточках выше. При старте запуск резервирует свою максимальную стоимость — плата за вызов плюс плата за результат, умноженная на max_results, — а затем списывается за то, что он вернул. Запуск, который завершился ошибкой или по тайм-ауту, оплачивает только доставленные результаты, а запуск, отклонённый на старте, ничего не стоит.

Подписки нет. Пополняйте баланс от $5, и с того же баланса оплачивается модель, которая переводит и обобщает. Цены на все инструменты — на странице Цены.

06

Частые вопросы

?
Можно ли искать на китайском?+

Да. Ключевые слова для Douyin могут быть на китайском или английском, а также хештегами, названиями брендов или эмодзи; Weibo принимает запросы на китайском, английском и вперемешку. Собственный пример инструмента Xiaohongshu ищет 露营 (кемпинг).

Xiaohongshu и RedNote — это одно и то же?+

Да. Xiaohongshu (小红书) также известен как RedNote, RED или XHS. Инструмент xiaohongshu-search — это API Xiaohongshu для поиска заметок, и в его схеме входных данных используются все эти названия.

Нужен ли китайский номер телефона или аккаунт на этих площадках?+

Нет. Аккаунт Xiaohongshu, Douyin или Weibo во входных данных не нужен. Все три инструмента вызываются с вашим API-ключом Lovely Router и JSON с ключевыми словами или ID.

Можно ли получить профили авторов и комментарии, а не только результаты поиска?+

В Weibo — да: userDetail возвращает профиль, а userFans и userFollowers — списки фанатов и подписчиков пользователя. В схеме инструмента Xiaohongshu есть операции для деталей и комментариев заметки по note_id и для профиля и заметок пользователя по user_id; нужная выбирается полем operation.

Приходят ли результаты на английском?+

Нет, они приходят на языке оригинала. Переведите или кратко изложите их любой чат-моделью через тот же ключ. Для китайскоязычных команд GET /v1/tools?lang=zh возвращает названия и описания инструментов каталога на китайском.

Как тарифицируется?+

За каждый возвращённый результат, с предоплаченного баланса, плюс плата за вызов в инструменте Weibo. Запуск никогда не стоит больше, чем плата за вызов плюс цена за результат, умноженная на max_results.

Для такого же исследования на глобальных площадках см. мониторинг соцсетей и исследование инфлюенсеров.

Один предоплаченный ключ для моделей, данных и агентов

Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.