logo
DE

TikTok Keyword Search

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

Original · en-USZur Übersetzung

Übersicht

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 IDMatched keywordContent URLCollection timeNo-data marker
7678592532162284813bluetooth earbudshttps://www.tiktok.com/@rebeccashao0/video/76785925321622848132026-08-27T15:13:22No
7678160781283822879bluetooth earbudshttps://www.tiktok.com/@stitch.series6/video/76781607812838228792026-08-27T15:13:22No

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.

Anwendungsbereich & Grenzen

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.

  • Geeignet für
  • 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.
  • Nicht verwenden für
  • 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.

Fehlerbehandlung

Vom Autor deklariertes Fehler- und Wiederholungsverhalten. Wir empfehlen, es bei der Integration in Ihren System-Prompt aufzunehmen.

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

Eingabe

Parameter, die zum Aufruf dieser App erforderlich sind, generiert aus dem input.schema in der manifest.json.

FeldFachlicher NameTypErforderlichStandardEnum / EinschränkungenBeispielBeschreibung
keywordSearch keywordstringJa——ShokzA brand, product, topic, or phrase to search on TikTok. Each task accepts one keyword from 1 to 512 characters.
crawl_countExpected result countintegerJa—1–2001Expected number of search results, from 1 to 200. Results are returned in complete batches of 10, so the actual count may be rounded up.

Ausgabe

Feldstruktur eines einzelnen Datensatzes, generiert aus dem output.schema in der manifest.json.

FeldFachlicher NameTypBeispielBeschreibung
content_idContent IDstring7678592532162284813Unique identifier of the matched TikTok video.
content_urlContent URLstringhttps://www.tiktok.com/@rebeccashao0/video/7678592532162284813Public TikTok video URL for the matched item.
keywordMatched keywordstringbluetooth earbudsSearch keyword associated with the collected content item.
keyword_typeKeyword typestringkeywordClassification of the search item associated with the record.
crawl_timeCollection timestring2026-08-27T15:13:22Timestamp associated with the collected record; the source does not specify a timezone.
cur_idCollection record IDstring6a8fe396b799f44efa7f2ff0Unique identifier of this collected row; it may differ from the TikTok video Content ID.
biz_idBusiness IDstringbluetooth earbudsBusiness grouping identifier returned with the collected record.
source_itemSource itemstringbluetooth earbudsKeyword item associated with the collection that produced this record.
no_dataNo-data markerbooleanfalseIndicates whether this search item produced no matching records.

Datensatz-Schema

Die Ausgabe wird Datensatz für Datensatz zurückgegeben. 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
}

Integration

Diese App kann über MCP, API, SDK oder Dateiexport integriert werden — alle Kanäle teilen sich dieselben Fähigkeiten und Preise. Jede Anfrage authentifiziert sich über den Authorization: Bearer-Header mit einem API Key (langlebig, in der Data Hub Konsole erstellt); MCP-Clients können sich zusätzlich per OAuth ohne Key anmelden. Weitere Optionen wie CLI und Skill sind in Vorbereitung.

Über das MCP (Model Context Protocol) können Sie diese App direkt aus KI-Clients wie Claude und Cursor aufrufen. Wählen Sie Ihren Client und den Authentifizierungsmodus und kopieren Sie dann die Konfiguration unten.

Client-Konfiguration

Ersetzen Sie den Wert nach Bearer durch Ihren langlebigen API Key. Funktioniert in jedem Client, in CI und in Headless-Umgebungen.

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>" }
    }
  }
}

Lassen Sie die KI die Einrichtung übernehmen

Sie möchten Konfigurationen nicht von Hand bearbeiten? Kopieren Sie den Installations-Prompt und fügen Sie ihn in einen beliebigen KI-Client ein — er schließt die Einrichtung auf seine eigene Weise ab. (Der Prompt weist die KI an, Ihren API Key bei Ihnen zu erfragen, damit Zugangsdaten nie im Chatverlauf oder in geteilten Konfigurationen landen.)

detail.access.mcp.composeHint

Preise

10 returned records

Berechnet nach der Anzahl der erfolgreich zurückgegebenen Datensätze. Fehlgeschlagene Läufe werden nicht berechnet. Abgerechnet in Einheiten von 10 Datensatz; jede angefangene Einheit wird auf 10 Datensatz aufgerundet.

0,002 $/ 10 Datensatz
Per task submitted

Wird pro übermitteltem Lauf einmal berechnet, unabhängig davon, wie viele Datensätze zurückgegeben werden.

0,0001 $/ Lauf

Mehrere Abrechnungsereignisse werden unabhängig voneinander kumuliert. Details siehe jeweilige Position. Fehlgeschlagene Läufe werden nicht berechnet.

Credits ansehen

Jetzt ausprobieren

Füllen Sie die Parameter aus und starten Sie — die Ergebnisse stammen aus einem echten Aufruf.

Beispiel
Parameter werden vor dem Absenden gegen input.schema validiert
Bitte füllen Sie zuerst die Pflichtparameter aus
Ab 0,002 $ / 10 Datensatz