EN

Douyin Keyword Search

Search one Douyin keyword and return matching public videos, publishers, engagement metrics, and timestamps.

Developer
Pricing
From $0.0015 / 10 records
Last updated
2026-09-16

Overview

Keyword research on Douyin often starts with a simple phrase but quickly turns into a fragmented set of videos, accounts, and engagement signals. This app gathers public search results for one brand, product, topic, or campaign keyword and turns them into a structured content dataset. Each record connects the content itself with its publishing account, publication time, media links, and the engagement values visible when it was collected. The dataset is suited to research that needs evidence at the individual-content level. It preserves source identifiers and public URLs so analysts can trace notable results, while also retaining titles, account attributes, tags, recognized speech or on-screen text when available, and multiple engagement counters for comparison.

Data notes

Results come from Douyin's public keyword search and are deduplicated by Content ID. Ordering follows the selected search order and publication-period filter. Engagement values and follower counts are stored as numeric strings, while cooperation details, image lists, music details, publish locations, and topic tags remain in their original text representation. Collection time and Publish time use the source representation, whose time zone is not specified. Video duration is also preserved as a numeric string, but the source does not identify its unit. The dataset covers only public content discoverable through keyword search; deleted, private, login-only, and non-indexed content are outside its scope.

What the results look like

Each record represents one Douyin item found for the submitted keyword.

Content IDContent titleAccount namePublish timeLike countComment count
6760573437619473671lol最逆天的彩蛋!揭晓! #lol呼叫网管2019-11-18T17:18:59547844.05446.0
7029249241700699400《改口》真实经历#lol酒鬼大人2021-11-11T17:57:06474147.021519.0
Additional fields include public content and account URLs, follower count, favorites, shares, downloads, video duration, verification details, recognized speech, on-screen text, music information, locations, and topic tags.

Use cases

  • For brand or campaign monitoring, compare Matched keyword, Publish time, Content title, and Like count to identify topics that attract attention over time.
  • For creator discovery, combine Account name, Account URL, Follower count, Verification status, and engagement counters to shortlist relevant public accounts.
  • For content benchmarking, group records by Topic tags and compare Like count, Comment count, Favorite count, and Share count to find formats and themes associated with stronger interaction.

Scope and boundaries

One 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; public searchable content only.

  • Good for
  • When you need to discover public Douyin content about a brand, product, topic, or campaign.
  • When you need a structured dataset of videos, publishing accounts, timestamps, and engagement metrics for content research.
  • Do not use for
  • When you need comments from an individual video; this app returns keyword search results rather than comment details.
  • When you need deleted, private, login-only, or otherwise non-searchable Douyin content.

Failure handling

Failure and retry behavior declared by the developer. We recommend including it in your system prompt when integrating.

  1. 1If no results are returned, shorten or rephrase the keyword and submit a new task.
  2. 2Retry later after rate limits, temporary service errors, or timeouts; check the execution credential configuration after an authentication failure.
  3. 3Keep completed records after a partial success; resubmit the same input after a failed or expired task.

Input

Parameters required to call this App, generated from the input.schema in manifest.json.

  • Search keywordkeywordRequiredstring
    Brand, product, topic, or phrase to search on Douyin. Each task accepts one keyword from 1 to 512 characters.
    Example韶音
  • Expected result countcrawl_countRequiredinteger
    Expected number of results, from 1 to 200. Results arrive in complete batches of 10, so the actual count may be rounded up.
    Range1–200Example50
  • Sort ordersortRequiredstring(enum)
    Choose comprehensive relevance or newest-first ordering for the search results.
    Allowed valuesComprehensive1Newest4Example4
  • Publication periodtime_limitRequiredstring(enum)
    Limit results to content published within the last day, or search without a publication-time limit.
    Allowed valuesPast day1Any time0Example0

Output

Field structure of a single record, generated from the output.schema in manifest.json.

  • Account IDaccountIdstring
    Douyin identifier of the publishing account.
    Example109014805831
  • Account nameaccountNamestring
    Display name of the publishing account.
    Example呼叫网管
  • Account secure IDaccountSecIdstring
    Encrypted Douyin identifier of the publishing account.
    ExampleMS4wLjABAAAAAtnCpevF0YXW29cXbyJmXnSyq6qZL-PdV2x8Cl6PQpw
  • Account short IDaccountShortIdstring
    Short identifier shown for the publishing account when available.

Sample data

Generated from output.schema. Fields without a sample value use structural placeholders.

output.example
{
  "accountId": "109014805831",
  "accountName": "呼叫网管",
  "accountSecId": "MS4wLjABAAAAAtnCpevF0YXW29cXbyJmXnSyq6qZL-PdV2x8Cl6PQpw",
  "accountShortId": "<accountShortId>",
  "accountUniqueId": "HJWG",
  "accountUrl": "https://www.douyin.com/user/MS4wLjABAAAAAtnCpevF0YXW29cXbyJmXnSyq6qZL-PdV2x8Cl6PQpw",
  "accurateLocationCities": "<accurateLocationCities>",
  "accurateLocationProvinces": "<accurateLocationProvinces>",
  "anchorInfo": "<anchorInfo>",
  "asrText": "<asrText>",
  "avatarUrl": "https://p11.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_5c0c342a89f6ce58ccd71b497a37a53e.heic?from=327834062",
  "bizId": "英雄联盟",
  "collectionCount": "3196.0",
  "commentCount": "5446.0",
  "contentId": "6760573437619473671",
  "contentText": "<contentText>",
  "contentTitle": "lol最逆天的彩蛋!揭晓! #lol",
  "contentUrl": "https://www.douyin.com/video/6760573437619473671",
  "cooperationInfos": "[]",
  "coverUrl": "https://p95-sz-sign.douyinpic.com/tos-cn-p-0015/53734fedbaec4ad3968a06c6cb295e7e~tplv-dy-resize-walign-adapt-aq:540:q75.heic",
  "crawlTime": "2026-09-09T16:39:38",
  "diggCount": "547844.0",
  "downloadCount": "8463.0",
  "fans": "12170016",
  "forwardCount": "20.0",
  "imageUrlList": "[]",
  "isHot": "false",
  "keyword": "英雄联盟",
  "music": "{\"audition_duration\":\"78\",\"author\":\"呼叫网管\",\"owner_id\":\"109014805831\",\"owner_nickname\":\"呼叫网管\",\"id\":\"6760527209229798151\",\"title\":\"@呼叫网管创作的原声\"}",
  "ocrText": "<ocrText>",
  "poiInfo": "<poiInfo>",
  "publishLocation": "{}",
  "publishTime": "2019-11-18T17:18:59",
  "shareCount": "8616.0",
  "status": "有效",
  "tags": "[\"lol\"]",
  "taskMeta": "<taskMeta>",
  "verified": "<verified>",
  "verifyType": "<verifyType>",
  "videoDuration": "78468.0",
  "videoUrl": "https://www.douyin.com/aweme/v1/play/?video_id=v0300fg10000dagho0nog65j2h6olpi0",
  "viewCount": "0.0"
}

Integration

This App can be integrated via MCP, API, SDK, or file export. All channels share the same capabilities and pricing. Every request authenticates with the Authorization: Bearer header using an API key (long-lived, created in the Data Hub Console); MCP clients can also sign in with OAuth, no key required. More options such as CLI and Skill are on the way. This App runs asynchronously and can be canceled midway: After you cancel, the run stops. Records already delivered are kept and billed.

With the MCP (Model Context Protocol), you can call this App directly from AI clients like Claude and Cursor. Pick your client and auth mode, then copy the config below.

Client config

Replace the value after Bearer with your long-lived API key. Works in any client, CI, or headless environment.

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

Let AI set it up for you

Don't want to edit configs by hand? Copy the install prompt and paste it into any AI client. It will complete the setup its own way. (By default it guides you through signing in, and never asks you to send your API key in the chat.)

detail.access.mcp.composeHint

Pricing

Task start

Charged once per submitted run, regardless of how many records are returned.

$0.0001/ run
Returned Douyin records

Charged by the number of records successfully returned. Failed runs are not charged. Billed in units of 10 records; any partial unit is rounded up to 10 records.

$0.0015/ 10 records

Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.

View credits

Try it now

Fill in the parameters and run. Results come from a real call.

Example
Parameters are validated against input.schema before submission
From $0.0015 / 10 records