TikTok Keyword Search

Give one TikTok search keyword and an expected count to get matching public video identifiers, links, and collection metadata.

原文 · en-US訳文に戻す

データ収集 Social Media TikTok Videos

概要

Researching how a topic appears in TikTok search often starts with a dependable set of matching video identifiers and public links. This app turns one search keyword into a structured collection of matching items, keeping the keyword and collection context beside each identifier so the dataset remains understandable after it is exported or joined with other research material.

The result is useful as a discovery index: it shows which public videos were associated with a brand, product, topic, or campaign at collection time. It is especially suited to building repeatable monitoring sets, comparing the content populations found for different terms, and preparing identifiers and links for later analysis without manually copying items from search pages.

Data notes

Each record represents one TikTok item associated with the submitted search keyword. Content IDs are de-duplicated within the returned dataset. Matched keyword, Source item, and Business ID preserve the collection context and may repeat across many records from the same search. Collection time is returned without timezone information, so it should not be treated as an absolute cross-region timestamp without additional context. Keyword type describes the kind of search item attached to the record.

The collection contains identifiers, public video links, and collection metadata, not captions, transcripts, engagement totals, comments, or a complete creator profile. A No-data marker distinguishes search metadata that reports no matching content from ordinary matched records. Private, deleted, or otherwise non-searchable TikTok content is not covered.

What a result looks like

Each row is one matched TikTok video or a no-data marker associated with the search keyword.

Content ID	Matched keyword	Content URL	Collection time	No-data marker
7678592532162284813	bluetooth earbuds	https://www.tiktok.com/@rebeccashao0/video/7678592532162284813	2026-08-27T15:13:22	No
7678160781283822879	bluetooth earbuds	https://www.tiktok.com/@stitch.series6/video/7678160781283822879	2026-08-27T15:13:22	No

Keyword type, Collection record ID, Business ID, and Source item are also available when supplied with the record.

Use cases

For topic discovery, group rows by Matched keyword and count distinct Content ID values to compare the searchable video population associated with each term.
For monitoring, repeat a keyword collection and compare Content ID sets while using Collection time as source-provided context for newly observed items.
For provenance checks, compare Matched keyword, Source item, and Business ID to confirm which search context produced each video before combining datasets.
For follow-up review, open Content URL values and filter on No-data marker to separate empty-search metadata from usable matched records.

適用範囲と境界

One TikTok search keyword per task with an expected result count from 1 to 200; results are returned in complete batches of 10 and may be rounded up; coverage is limited to public TikTok keyword search listings.

適している用途
When you need content identifiers and public video links returned by a TikTok keyword search for a brand, product, topic, or campaign.
When you need a structured list that connects each matched video with its search keyword and collection metadata.

適さない用途
When you need captions, transcripts, engagement metrics, comments, or complete creator profiles.
When you need an immediate single-record lookup rather than a background keyword collection task.

失敗時の処理

作者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。

1If no matching records are returned, verify the keyword or try a shorter and broader search phrase.
2Keep completed records after a partial success; resubmit the same input after a failed or expired task.
3Retry later after rate limiting, temporary service unavailability, or a timeout.
4If authentication fails, verify the API Key configured for the execution environment.

入力

この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。

フィールド	業務名称	型	必須	デフォルト	列挙値／制約	例	説明
keyword	Search keyword	string	はい	—	—	Shokz	A brand, product, topic, or phrase to search on TikTok. Each task accepts one keyword from 1 to 512 characters.
crawl_count	Expected result count	integer	はい	—	1–200	1	Expected number of search results, from 1 to 200. Results are returned in complete batches of 10, so the actual count may be rounded up.

出力

1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。

フィールド	業務名称	型	例	説明
content_id	Content ID	string	7678592532162284813	Unique identifier of the matched TikTok video.
content_url	Content URL	string	https://www.tiktok.com/@rebeccashao0/video/7678592532162284813	Public TikTok video URL for the matched item.
keyword	Matched keyword	string	bluetooth earbuds	Search keyword associated with the collected content item.
keyword_type	Keyword type	string	keyword	Classification of the search item associated with the record.
crawl_time	Collection time	string	2026-08-27T15:13:22	Timestamp associated with the collected record; the source does not specify a timezone.
cur_id	Collection record ID	string	6a8fe396b799f44efa7f2ff0	Unique identifier of this collected row; it may differ from the TikTok video Content ID.
biz_id	Business ID	string	bluetooth earbuds	Business grouping identifier returned with the collected record.
source_item	Source item	string	bluetooth earbuds	Keyword item associated with the collection that produced this record.
no_data	No-data marker	boolean	false	Indicates whether this search item produced no matching records.

レコード Schema

出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint

output.schema

{
  "type": "object",
  "properties": {
    "content_id": {
      "type": "string",
      "title": "Content ID",
      "description": "Unique identifier of the matched TikTok video.",
      "prefill": "7678592532162284813"
    },
    "content_url": {
      "type": "string",
      "title": "Content URL",
      "description": "Public TikTok video URL for the matched item.",
      "prefill": "https://www.tiktok.com/@rebeccashao0/video/7678592532162284813"
    },
    "keyword": {
      "type": "string",
      "title": "Matched keyword",
      "description": "Search keyword associated with the collected content item.",
      "prefill": "bluetooth earbuds"
    },
    "keyword_type": {
      "type": "string",
      "title": "Keyword type",
      "description": "Classification of the search item associated with the record.",
      "prefill": "keyword"
    },
    "crawl_time": {
      "type": "string",
      "title": "Collection time",
      "description": "Timestamp associated with the collected record; the source does not specify a timezone.",
      "prefill": "2026-08-27T15:13:22"
    },
    "cur_id": {
      "type": "string",
      "title": "Collection record ID",
      "description": "Unique identifier of this collected row; it may differ from the TikTok video Content ID.",
      "prefill": "6a8fe396b799f44efa7f2ff0"
    },
    "biz_id": {
      "type": "string",
      "title": "Business ID",
      "description": "Business grouping identifier returned with the collected record.",
      "prefill": "bluetooth earbuds"
    },
    "source_item": {
      "type": "string",
      "title": "Source item",
      "description": "Keyword item associated with the collection that produced this record.",
      "prefill": "bluetooth earbuds"
    },
    "no_data": {
      "type": "boolean",
      "title": "No-data marker",
      "description": "Indicates whether this search item produced no matching records.",
      "prefill": false
    }
  },
  "required": [],
  "additionalProperties": false
}

連携方法

この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key（長期有効。Data Hub コンソールで作成）を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。

MCP（Model Context Protocol）を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。

クライアント設定

Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。

mcpServers config

{
  "mcpServers": {
    "hello_moto__tiktok-keyword-list": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/tiktok-keyword-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

自分の API Keys を表示 →

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します（プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません）。

detail.access.mcp.composeHint

料金

10 returned records

正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 10 件を 1 つの課金単位とし、端数は 10 件に切り上げて課金されます。

$0.002/ 10 件

Per task submitted

返される件数にかかわらず、実行の送信 1 回ごとに課金されます。

$0.0001/ 回

複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。

Credits を確認

今すぐ試す

パラメータを入力して実行してください。結果は実際の呼び出しによるものです。

サンプル

パラメータは送信前に input.schema で検証されます

Search keywordkeyword*A brand, product, topic, or phrase to search on TikTok. Each task accepts one keyword from 1 to 512 characters.

Expected result countcrawl_count*Expected number of search results, from 1 to 200. Results are returned in complete batches of 10, so the actual count may be rounded up.

まず必須パラメータを入力してください

$0.002 / 10 件から