Give one Twitter search keyword and an expected count to get matching public post identifiers, publish times, and collection metadata.
Douyin Keyword Search
Search one Douyin keyword and return matching public videos, publishers, engagement metrics, and timestamps.
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 ID | Content title | Account name | Publish time | Like count | Comment count |
|---|---|---|---|---|---|
| 6760573437619473671 | lol最逆天的彩蛋!揭晓! #lol | 呼叫网管 | 2019-11-18T17:18:59 | 547844.0 | 5446.0 |
| 7029249241700699400 | 《改口》真实经历#lol | 酒鬼大人 | 2021-11-11T17:57:06 | 474147.0 | 21519.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.
- 1If no results are returned, shorten or rephrase the keyword and submit a new task.
- 2Retry later after rate limits, temporary service errors, or timeouts; check the execution credential configuration after an authentication failure.
- 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 keyword
keywordRequiredstringBrand, product, topic, or phrase to search on Douyin. Each task accepts one keyword from 1 to 512 characters.Example韶音 - Expected result count
crawl_countRequiredintegerExpected 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 order
sortRequiredstring(enum)Choose comprehensive relevance or newest-first ordering for the search results.Allowed valuesComprehensive1Newest4Example4 - Publication period
time_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 ID
accountIdstringDouyin identifier of the publishing account.Example109014805831 - Account name
accountNamestringDisplay name of the publishing account.Example呼叫网管 - Account secure ID
accountSecIdstringEncrypted Douyin identifier of the publishing account.ExampleMS4wLjABAAAAAtnCpevF0YXW29cXbyJmXnSyq6qZL-PdV2x8Cl6PQpw - Account short ID
accountShortIdstringShort identifier shown for the publishing account when available.
Sample data
Generated from output.schema. Fields without a sample value use structural placeholders.
{
"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": {
"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
Charged once per submitted run, regardless of how many records are returned.
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.
Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.
View creditsTry it now
Fill in the parameters and run. Results come from a real call.