TikTok API で動画、ハッシュタグ、トレンドを検索できますか?
はい、TikTok API では動画、広告、トレンドをそれぞれ別の API で検索できます。Research API は、TikTok が承認した研究者向けに、公開動画をキーワード、ハッシュタグ、ユーザー名、地域、日付で検索します。Commercial Content API は、キーワードまたは広告主名で広告を検索します。API for Business は、人気のハッシュタグ、そのハッシュタグのトレンド動画、トレンド検索キーワードを返します。Display API は、認可されたユーザー本人のプロフィールと動画を読み取ります。
easyCoexistence は、TikTok の API for Business を通じて TikTok アカウントを接続します。
Research API のリクエストは 1 日あたり最大 100,000 件のレコードまで許可されます。1 日の上限は UTC 午前 0 時にリセットされます。
1 回の Research API 動画クエリで start_date と end_date の間に指定できる最長期間。1 リクエストで最大 100 本の動画を返します。
人気ハッシュタグ /discovery/trending_list/ は、国とカテゴリごとに、直近 1、7、30、120 日間のランキングを返します。
トレンド検索キーワード /discovery/trending/search/ は、Advanced Access または Verified Business Account のアカウントに対して返されます。
Commercial Content API が受け付ける search_term の最長文字数。既定では exact_phrase、または fuzzy_phrase として照合されます。
どの TikTok API で何を検索できますか?
用途に応じて複数あり、それぞれ異なる種類の開発者向けです。developers.tiktok.com には Research API、Commercial Content API、Display API があり、business-api.tiktok.com には API for Business があります。トレンドと企業自身のコンテンツを扱う Discovery、Accounts、Mentions の各エンドポイントを備えています。次のとおりです:
Research API はどのように動画を検索しますか?
クライアントアクセストークンと research.data.basic スコープを持たせて、POST https://open.tiktokapis.com/v2/research/video/query/ を呼び出します。query オブジェクトでは、keyword、hashtag_name、username、region_code、create_date、video_length などのフィールドに対する EQ や IN といった操作を、and、or、not で組み合わせられます。start_date と end_date は YYYYMMDD 形式で、30 日以内の間隔で指定できます。max_count は 1 リクエストあたり最大 100 本の動画を返します:
curl -X POST 'https://open.tiktokapis.com/v2/research/video/query/?fields=id,video_description,create_time' \
-H 'Authorization: Bearer <CLIENT_ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"query": {
"and": [
{ "operation": "IN", "field_name": "region_code", "field_values": ["JP", "US"] },
{ "operation": "EQ", "field_name": "hashtag_name", "field_values": ["animal"] }
],
"not": [
{ "operation": "EQ", "field_name": "video_length", "field_values": ["SHORT"] }
]
},
"max_count": 100,
"start_date": "20261001",
"end_date": "20261030"
}'Research API は何を返し、データはどのくらい新しいですか?
fields で指定した公開動画のフィールド(id、video_description、create_time、region_code、view_count、like_count、comment_count、share_count、hashtag_names、username など)を返します。TikTok の FAQ によれば、再生数やフォロワー数などの統計は更新に最大 10 日かかることがあり、新しい動画が検索に現れるまで最大 48 時間かかることがあります。1 日の上限は 1,000 リクエストと、Research API 全体で最大 100,000 件のレコードで、UTC 午前 0 時にリセットされます。
Research API を利用できるのは誰ですか?
TikTok がプロジェクトを承認した研究者です。開発者アカウントだけではアクセスできません。TikTok が対象として挙げるのは、米国、EEA、英国、カナダ、スイスの学術機関、EU の非営利または独立の研究機関、そしてオンラインの若年者の安全を研究するブラジルの学術・非営利組織です。申請者は商業的な利害から独立して活動しており、明確な研究提案、資金提供元の開示、倫理審査があることが必要です。TikTok は通常 4 週間以内に回答します。クリエイター、広告主、商業利用者が対象になるかという質問に対して、TikTok の FAQ の回答は「いいえ」です。
Commercial Content API で広告を検索するにはどうしますか?
research.adlib.basic スコープを付けて、POST https://open.tiktokapis.com/v2/research/adlib/ad/query/ を呼び出します。search_term は最大 50 文字で、既定では exact_phrase で照合されます。fuzzy_phrase を指定すると、語順を問わず、いずれかまたはすべての単語を含む広告を検索します。フィルターは掲載日と対象国で結果を絞り込み、1 回の呼び出しで返すのは最大 10 件です。TikTok の製品ページによると、データは EU の広告から始まり、広告の最終表示から 1 年後まで利用できます。どの国の一般利用者や研究者も、オンラインフォームから申請できます。TikTok は 2 営業日以内に回答する見込みです。
API for Business はどのトレンドを返しますか?
Discovery エンドポイントが返すトレンドです。使用するトークンによって異なります。/discovery/trending_list/ は、国(既定は米国)と業界カテゴリごとに、直近 1、7、30、120 日間の人気ハッシュタグを最大 200 件ランキングし、各ハッシュタグの順位、再生数、投稿数を返します。/discovery/video_list/ は、それらのハッシュタグのうち最大 10 件について、トレンド動画の上位 20 件を返します。どちらも advertiser_id と広告主のアクセストークンを必要とします。さらに 2 つは、discovery.search.words スコープを持つ TikTok アカウントのトークンを必要とし、Advanced Access または Verified Business Account のアカウントが対象です:
- /discovery/trending/search/:TikTok で流行している検索キーワードを 20 件。
is_personalizedを指定すると、アカウントに合わせたキーワードを返します。 - /discovery/trending/search/keyword/:製品やブランドなど、最大 255 文字のクエリに対して推奨される検索キーワードを 20 件。
TikTok アカウント自身の API では何を検索できますか?
キャプション用のハッシュタグと、ブランドのハッシュタグを付けた投稿です。GET /business/hashtag/suggestion/ は keyword と任意の language を受け取り、完全一致、次に投稿数の順に並べた 10 件のハッシュタグを、それぞれの post_count とともに返します。Mentions エンドポイント /business/mention/hashtag/video/list/ は、企業が有効にしたブランドハッシュタグのいずれかを使った、過去 90 日間の公開投稿を最大 1,000 件検索し、そのうち最大 50 件を、投稿時刻、いいね、コメント、シェアのいずれかで並べて返します。biz.brand.insights スコープと、Advanced Access または Verified Business Account のアカウントが必要です。
Display API で検索できますか?
いいえ。Display API はアプリを認可したユーザーを読み取ります。/v2/user/info/ はそのユーザーのプロフィールを返し、/v2/video/list/ は公開動画を新しい順に、1 ページ最大 20 件で返します。/v2/video/query/ は ID を指定して特定の動画を返します。いずれも user.info.basic と video.list のスコープの下で動作します。どのエンドポイントも、キーワードやハッシュタグを受け取りません。
easyCoexistence は TikTok で何を検索できますか?
接続された TikTok アカウント自身の API が答えられる内容です。list_social_posts はアカウントの最近の投稿を、list_social_comments は投稿のコメントを一覧表示します。business/ 配下の API for Business のパスは、ハッシュタグの候補を含め、get_social_credentials のトークンを使ってご自身のコードから呼び出します。/discovery/ のパスは広告主のトークンを受け取るため、アカウントのトークンでは呼び出せません。Research API と Commercial Content API は developers.tiktok.com の別製品で、それぞれ独自の申請が必要です。
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
?business_id=<BUSINESS_ID>&keyword=cold%20brew&language=en
Access-Token: <ACCESS_TOKEN>よくある間違い
- ブランドを追跡するために Research API を申請すること。TikTok の FAQ は、クリエイター、広告主、商業利用者に対して「いいえ」と答えており、承認されるのは非営利の研究プロジェクトです。
- 1 回の Research API 呼び出しで長い期間をクエリすること。end_date は start_date から最大 30 日後までなので、長い期間は区間に分割してください。
- ハッシュタグの候補をトレンドとして読むこと。/business/hashtag/suggestion/ は完全一致と投稿数で並べ、/discovery/trending_list/ は選んだ期間の人気を順位付けします。
- 個人アカウントでトレンド検索エンドポイントを呼び出すこと。これらは Advanced Access または Verified Business Account のアカウントに対して応答し、トークンには discovery.search.words スコープが必要です。
Claude、ChatGPT、または自社のプラットフォームが、list_social_comments でアカウントの投稿とコメントを一覧表示し、インサイトを読み取れます。また、get_social_credentials は、business/ 配下のエンドポイント(ハッシュタグの候補など)用のトークンを自社のコードに渡します。各接続は 24 時間体制で監視されます。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
API で TikTok の動画をキーワード検索できますか?
できます。TikTok が研究プロジェクトを承認した後に Research API を使用します。その動画クエリは公開動画に対して keyword と hashtag_name の条件を受け付け、1 リクエストあたり最大 100 本です。
トレンドのハッシュタグを取得できる TikTok API はありますか?
はい。API for Business の /discovery/trending_list/ は、国とカテゴリごとに人気ハッシュタグを最大 200 件、それぞれの再生数と投稿数とともに返します。広告主のトークンが必要です。
トレンド動画を取得できる TikTok API はありますか?
はい。API for Business の /discovery/video_list/ は、人気ハッシュタグ最大 10 件のトレンド動画上位 20 件を返します。advertiser_id と広告主のアクセストークンが必要です。
TikTok API で自分のアカウントに言及したコメントを見つけられますか?
Advanced Access または Verified Business Account のアカウントであれば可能です。Mentions API の /business/mention/comment/list/ は、アカウントを @メンションしているコメントまたは返信を最大 1,000 件返します。biz.brand.insights と comment.list のスコープが必要です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日