ユースケース

市場調査のための小紅書(RED)・抖音(Douyin)・微博(Weibo)API

中国語のキーワードで小紅書(RED)のノート、抖音(Douyin)の動画、微博(Weibo)の投稿を検索し、ブランド調査や市場調査に使える JSON で取得。成果課金です。

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで
小红书抖音微博lovelyjsonitems[0]"title": "露营装备清单""author": "山野小林""likes": 12800"collects": 4310"comments": 562"tags": ["露营", "户外"]

小紅書(小红书、Xiaohongshu。RedNote や RED とも呼ばれます)、抖音(Douyin)、微博(Weibo)は、中国の消費者が商品を見つけ、レビューし、ブランドについて語り合う場であり、そのやり取りの大半は中国語です。Lovely Router を使えば、この 3 つの中国 SNS のデータを API 呼び出しで検索できます。キーワードを送るとノート、動画、投稿が JSON で返され、結果ごとに課金されます。中国市場のリサーチを行うブランドや代理店向けに作られており、中国国外からローンチを計画している場合にも、国内で競合や KOL を追跡している場合にも使えます。

AI エージェントに任せる

このプロンプトを 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. キーワードを選ぶ

    顧客が実際に使う言葉で検索します。露营(キャンプ)、咖啡(コーヒー)、商品カテゴリー、ブランド名などです。抖音と微博は、英語のクエリやブランド名にも対応しています。

  2. max_results で上限を指定し、キーワードを POST /v1/tools/{id}/run に送ります。実行は最大費用を確保したうえで、結果を JSON で返します。

  3. 読む、翻訳する、要約する

    結果は元の言語のまま返されます。同じキーでモデルに送れば、日本語や英語に翻訳したり、要約やタグ付けをしたりできます。

02

1 回のリクエストで小紅書のノートを検索する

小紅書検索は、1 回の呼び出しで 1 つの 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 の 1 項目で、形式はツール独自のものです。結果をもとに何かを作り込む前に、まず小さな検索を実行してフィールドを確認してください。60 秒経っても終わらない実行は 202 を返します。ポーリングの方法はツールを実行するを参照してください。

抖音も同じように使えます。次の実行では、過去 1 週間で「いいね」が最も多いコーヒーの動画を最大 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

各ツールが返すもの

小紅書(RED)。 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 を指定)などがあります。操作を 1 つ選び、その操作で使うフィールドだけを入力してください。フィールドの説明は中国語と英語で書かれています。

抖音(Douyin)。 抖音検索は、1 つ以上の keywords に一致する動画を返します。中国語、英語、ハッシュタグ、ブランド名、絵文字のいずれも使えます。キーワードはそれぞれ個別に検索され、キーワード間の重複は取り除かれます。現実的なキーワードなら、重複のない動画が数百件得られます。並べ替えは general、most_liked、latest から選べ、publishTime で one_day、one_week、half_year に絞り込めます。

微博(Weibo)。 微博検索は、1 回の呼び出しで 1 つの operation を実行します。

操作入力返されるもの
searchWeibokeyword(中国語、英語、または混在)、maxPagesキーワードに一致する投稿(1 ページあたり約 14 件)
userDetailuserIdフォロワー数、フォロー数、投稿数、認証理由、所在地、性別、自己紹介
userFans、userFollowersuserId、maxPagesユーザーのファンまたはフォロワーの一覧(1 ページあたり約 20 人)

数値の userId は、プロフィールの URL(weibo.com/u/{ID})と、検索結果の userId または user_id フィールドで確認できます。

04

レシピ

ローンチ前に商品アイデアを検証する。

カテゴリー名を中国語で指定し、"sort_type": "like_count_descending" を付けて xiaohongshu-search を実行します。上位のノートに登場するブランド、価格帯、不満点を日本語で一覧にするよう、モデルに頼みます。

微博で KOL を見つける。

ブランド名やカテゴリーと "maxPages": 3 を指定して searchWeibo を実行し、繰り返し登場する userId を拾います。続いてそれぞれに userDetail を実行し、フォロワー数と認証理由を取得します。

抖音でトレンドを追う。

関連するいくつかのキーワードについて、"publishTime": "one_week" と "sort": "most_liked" を指定した douyin-search を毎週実行し、各週の上位の動画を比較します。

中国とほかの地域を比べる。

同じテーマを TikTok 検索で英語で検索し、"US" などの location を指定して、抖音の上位の動画とフォーマットやフックを比べます。

足りない部分を Web 検索で補う。

Web 検索は lang:zh 演算子で中国語の記事やニュースを検索でき、料金は検索 1 回につき $0.0009 です。

個人データ

クリエイターのプロフィールやフォロワーの一覧は、多くの地域で個人データにあたります。収集したデータを、あなた自身とデータに含まれる人々がいる場所の法律に従って適法に使う責任は、あなたにあります。利用規定を参照してください。

MCP サーバーを接続すれば、最初のレシピをプロンプト 1 つで実行できます。「小紅書で露营に関するノートをいいねの多い順に 30 件、微博で露营装备に関する投稿を検索して、どのブランドと商品が最もよく言及されているかを日本語でまとめて。すべての実行で max_results を指定すること」

05

支払う料金

各実行は結果(ノート、動画、投稿)1 件ごとに課金され、微博では呼び出しあたりの料金もかかります。現在の料金は上のカードに表示されています。実行を開始すると最大費用(呼び出しあたりの料金 + 結果 1 件あたりの料金 × max_results)が確保され、返した結果に応じて精算されます。失敗した実行やタイムアウトした実行は届いた結果の分だけ支払い、開始時に拒否された実行は無料です。

サブスクリプションはありません。$5 からチャージでき、翻訳や要約を行うモデルの料金も同じ残高から支払えます。すべてのツールの料金は料金を参照してください。

06

よくある質問

?
中国語で検索できますか?+

はい。抖音のキーワードには中国語、英語、ハッシュタグ、ブランド名、絵文字を使え、微博は中国語、英語、その混在のクエリに対応しています。小紅書ツール自体の入力例も、露营(キャンプ)を検索するものです。

小紅書と RedNote は同じものですか?+

はい。小紅書(小红书、Xiaohongshu)は RedNote、RED、XHS とも呼ばれます。RedNote の API として使える xiaohongshu-search ツールはそのノートを検索し、入力スキーマではこれらすべての名前が使われています。

中国の電話番号や各プラットフォームのアカウントは必要ですか?+

いいえ。小紅書、抖音、微博のアカウントは入力に含まれません。3 つのツールはすべて、Lovely Router の API キーと、キーワードや ID を指定した JSON 入力で呼び出します。

検索結果だけでなく、クリエイターのプロフィールやコメントも取得できますか?+

微博では可能です。userDetail はプロフィールを、userFans と userFollowers はユーザーのファンとフォロワーの一覧を返します。小紅書ツールのスキーマには、note_id を指定してノートの詳細とコメントを、user_id を指定してユーザーのプロフィールとノートを取得する操作が載っており、operation フィールドで選びます。

結果は日本語や英語で返されますか?+

いいえ、元の言語のまま返されます。同じキーで任意のチャットモデルを使えば、翻訳や要約ができます。中国語を話すチーム向けには、GET /v1/tools?lang=zh でカタログのツール名と説明を中国語で取得できます。

料金はどのように課金されますか?+

返された結果 1 件ごとにプリペイド残高から課金され、微博ツールでは呼び出しあたりの料金もかかります。1 回の実行の費用が、呼び出しあたりの料金と、結果 1 件あたりの料金に max_results を掛けた額の合計を超えることはありません。

グローバルなプラットフォームで同じリサーチを行うには、ソーシャルリスニングとインフルエンサーリサーチを参照してください。

モデル・データ・エージェントを 1 つのプリペイドキーで

サブスクリプションなし。チャージして必要な分だけ使い、すべての請求をログで確認できます。