🔥 FREE BETA — Douyin 抖音 Search Scraper | 20 Keywords + No-Watermark MP4

Search public Douyin (抖音) with up to 20 search keywords per run and optional No-Watermark MP4 downloads for eligible videos. Export rich creator, content, engagement, hashtag and music data, with cross-keyword deduplication and searchMatches showing observed keyword matches. No Douyin account, imported cookies or QR login required. Metadata-only is the default.

FREE BETA — no additional developer/provider charge. Normal Apify usage, storage and transfer charges still apply.

免费测试版：每次最多搜索 20 个关键词，跨词去重，获取公开内容、创作者和互动等元数据， 并可选下载符合条件的无水印 MP4。无需抖音账号或导入 Cookie；开发者不额外收费， Apify 运行、存储和传输费用仍按平台规则收取。

Why choose this beta?

• Compare product categories or competing brands in one request with up to 20 keywords; searchMatches shows which searches actually found each post.
• Find public posts and their associated creators, then explore available engagement, hashtags and music signals for content planning.
• Keep one row per post across keyword searches and export structured results for research or downstream automation.
• Pair your research with optional No-Watermark MP4 downloads for eligible videos.

Paid alternatives can add a provider fee. This beta adds none: your costs are normal Apify usage, storage and transfer charges.

一次请求可研究多个品类或竞品，用公开帖子、关联创作者及可用互动数据辅助选题。 跨词去重和关键词匹配记录便于比较，结构化结果便于导出或接入自动化流程； 还可选下载符合条件的无水印 MP4。免费测试版不加收提供方费用，Apify 平台费用仍适用。

Quick start

Enter a keyword and a small result ceiling, then run the Actor:

{
  "keyword": "街头美食",
  "max_results": 5
}

max_results is optional. Omit it to use the normal bounded search: no numeric target, returning the unique results found until natural completion or the existing time and resource limits. The prefilled 5 is a UI starting value, not an API default; an explicit value replaces it.

For metadata from several keywords, supply an ordered list instead:

{
  "keywords": ["街头美食", "咖啡"],
  "max_results": 100
}

This requests up to 100 results for each keyword. Overlapping items appear once, with searchMatches recording the keywords where each item was actually observed. Use exactly one of keyword or keywords.

To include MP4 downloads for a single keyword:

{
  "keyword": "咖啡",
  "media_max_items": 5
}

The same ceiling can span a keyword list:

{
  "keywords": ["街头美食", "咖啡"],
  "media_max_items": 5
}

Open the run's default Dataset for search results and OUTPUT for the run summary. With media requested, check MEDIA_MANIFEST for delivered files in the run's default key-value store.

What you get

The Dataset contains one row per usable public item found, including its Douyin item ID (awemeId), public URL (publicUrl) and content type (itemType). Available details include:

• Caption, separate item title, source language label, and creation time including UTC ISO time when supported.
• Public creator IDs, name, handle, verification information and exposed profile counters.
• Likes, comments, collects, shares and other exposed engagement counters.
• Hashtag IDs and names.
• Music/sound ID, title, author, album and source originality flag.
• Video duration, width, height and source ratio label.
• Image count and dimensions for confirmed image posts, and source topic labels.
• Observed keyword matches and bounded source positions, separate from global search rank.

The Dataset schema documents 42 potentially available fields; it does not guarantee all 42 on every row. Optional fields vary by item. Creator counters are not independently verified profile totals, and a reported zero play count does not prove zero real views.

Illustrative Dataset row

This subset comes from a validated synthetic test fixture, not a real production observation. It shows how a post, associated creator and observed keyword match appear together. Other optional fields, such as follower counts, comments and hashtags, are omitted here because this fixture does not supply them. 以下为经过测试验证的模拟数据节选，并非真实生产观察；可选字段不保证每条都有。

{
  "keyword": "防晒",
  "awemeId": "7456789012345678901",
  "publicUrl": "https://www.douyin.com/video/7456789012345678901",
  "itemType": "VIDEO",
  "authorNickname": "公开作者",
  "likeCount": 17,
  "searchMatches": [
    {
      "keyword": "防晒",
      "keywordIndex": 0,
      "sourcePositions": [{"representation": "search-response", "sourceSequence": 0, "sourcePosition": 1}],
      "sourcePositionsTruncated": false,
      "sourceCaptureTruncated": false,
      "sourcePositionsComplete": true
    }
  ]
}

MP4 downloads / No Watermark

Optionally download eligible Douyin videos as MP4 files, including no-watermark files when available. Watermark-free output is not guaranteed for every video.

Successful files use deterministic MEDIA_<aweme_id>.mp4 keys in the initiating run's default key-value store. MEDIA_MANIFEST lists selected videos and their delivered or unavailable outcomes; OUTPUT summarizes the counts. Files follow that store's retention settings. This Actor is not a permanent public media library.

Not every search result is an eligible VIDEO, and a media source or transfer may be unavailable. The requested media count is a ceiling, not a delivery guarantee; metadata remains available even when a selected MP4 is unavailable. For keyword lists, the ceiling applies once to the invocation and overlapping identities consume the budget once. Only final canonical VIDEO results are buyer-eligible after all keyword results are combined. If later evidence makes an early candidate IMAGE, UNKNOWN or CONFLICT, it is excluded without selecting a replacement. One invocation-wide manifest contains only final eligible items; counts exclude invalidated candidates.

Input reference

Input	Label	Usage
keyword	Keyword	Supply this or keywords. One search keyword of 1–128 Unicode characters, without leading/trailing whitespace or control characters. Internal spaces are allowed.
keywords	Keywords	Ordered list of 1–20 exact distinct keywords, with the same text rules as keyword. Accepted text is preserved without normalization.
max_results	Maximum results	Optional ceiling on returned metadata rows per keyword. Fewer results may be available. Leave empty to return the unique results found within the search time and resource limits.
media_max_items	Maximum MP4 downloads	Optional invocation-wide ceiling on MP4 selections from final canonical VIDEO results, including keyword lists. Leave empty for metadata only. Media can increase run time and Apify usage, storage, and transfer costs.

Both optional controls accept positive integers. Media selection uses only final eligible returned results. Results follow keyword order, then source observation order; the Actor does not verify relevance or latest ordering or establish complete search coverage.

AI agents and API usage

Use Actor Store identifier plutonus/douyin-scraper. Valid inputs include {"keyword":"街头美食"} for metadata or {"keyword":"咖啡","media_max_items":5} for metadata with optional MP4 downloads.

Runs can be long-running and exceed five minutes. Start asynchronously, then poll for completion or use a completion webhook. After completion, read:

• The default Dataset for structured search results.
• OUTPUT in the default key-value store for status and counts.
• MEDIA_MANIFEST when media is requested, for selected items and delivery outcomes.
• Delivered MEDIA_<aweme_id>.mp4 records in that same store for MP4 files.

If your AI assistant has an authorized Apify integration, copy this instruction:

Using your authorized Apify integration, start Actor byl5JNl8nNf8pWtCn
(plutonus/douyin-scraper) asynchronously with
{"keywords":["护肤","减脂"],"max_results":50}.
Poll until the run finishes, then read its default Dataset and OUTPUT.
Compare the available posts and engagement data by observed keyword matches;
report result counts, per-keyword outcomes and any coverage or execution limits.

仅适用于已获授权接入 Apify 的 AI 助手：异步启动、轮询完成后读取 Dataset 和 OUTPUT， 按实际关键词匹配比较内容，并报告可用结果及限制。

Run output and status reference

Read OUTPUT.status alongside the Dataset and media outcomes. A run can return useful rows with limitations; metadata success does not guarantee media delivery.

Output	Meaning
status: SUCCEEDED	Useful results were returned with the search mode verified; coverage and ordering guarantees still do not apply.
status: SUCCEEDED_WITH_LIMITATIONS	Search completed with bounded coverage or unverified ordering; check result counts and per-keyword outcomes.
status: PARTIAL	Valid multi-keyword results were delivered, with at least one requested keyword incomplete, failed or unexecuted. Usable rows are retained.
status: PARTIAL_WITH_ROWS	Search ended incompletely; the usable rows collected are retained in the Dataset.
status: NO_TRUSTWORTHY_RESULTS	Search returned no usable public results.
status: WORKER_FAILED	Search failed to produce a usable result.
status: CAPACITY_UNAVAILABLE	Beta capacity was unavailable; no search was queued.
status: WORKER_UNCERTAIN	Search outcome is uncertain; the request was not reassigned or repeated.
status: GATEWAY_UNAVAILABLE	The search service could not be reached reliably; search completion is unknown.
acquisitionStatus	BOUNDED means a normal bounded search stop; INCOMPLETE means search ended incompletely; UNPROVEN means no established acquisition outcome.
acquisitionStopReason	The reason search stopped. RESULT_LIMIT_REACHED is a normal bounded stop at the requested result ceiling; NATURAL_EXHAUSTION means the source offered no further continuation for that search. Neither establishes complete coverage.
requestedMaxResults	The per-keyword metadata ceiling requested, when supplied.
batchStatus / keywordOutcomes	For multiple keywords: COMPLETE, PARTIAL or FAILED, and ordered per-keyword outcomes. Bounded completion does not mean exhaustive coverage.
datasetItemCount / usefulItemCount	Number of returned metadata rows.
modeVerification / orderingGuarantee / completeSearchCoverage	Search-mode verification and ordering/coverage limits. These are separate from successful row delivery.
requestedMediaMaxItems	For multi-keyword media: the invocation-wide requested ceiling.
mediaStatus / mediaSelectedCount / mediaDeliveredCount / mediaUnavailableCount	Overall MP4 outcome and selected, delivered and unavailable counts. Per-item outcomes are in MEDIA_MANIFEST.

Costs and beta limitations

The free beta adds no developer/provider charge. Normal Apify usage, storage and transfer costs apply, including for runs with fewer results or files than requested. MP4 downloads can increase run time and these costs.

Beta capacity may sometimes be unavailable. Result and MP4 counts are not guaranteed, and there is no latency, production reliability or SLA promise. Multi-keyword delivery limits the serialized Dataset to 32 MiB. If the result exceeds this initial Apify resource bound, delivery stops without writing partial results or silently truncating rows. Large permitted input combinations still require resource/load acceptance; the input limits are not an availability promise. The Actor supports public keyword search, not private/authenticated data or selectable sort and filter controls.

简体中文使用指南

本 Actor 按关键词搜索抖音公开内容，适合内容选题、创作者研究和市场调研。 返回的是公开帖子及其关联创作者元数据，不是完整的达人数据库。 Dataset 文档定义了 42 个可能出现的字段，并非每条结果都有全部字段。

在 Apify 输入表单填写关键词和较小的结果上限，然后启动运行。单关键词搜索示例：

{"keyword": "街头美食", "max_results": 5}

多词搜索时改用 keywords，同时清空表单中预填的 keyword：

{"keywords": ["护肤", "减脂"], "max_results": 50}

keyword 与 keywords 必须且只能填写一项；列表最多 20 个不重复的关键词。 max_results 是每个关键词的结果上限，上例去重后最多 100 条，实际可能因结果不足或 跨词重叠而更少。留空不设数量目标，仍受运行时间和资源限制；表单预填的 5 不是 API 默认值。 相同帖子只输出一次，searchMatches 记录实际观察到的关键词匹配，不代表全站搜索排名。

默认仅返回元数据。如需尝试下载 MP4，可加入 media_max_items：

{"keywords": ["护肤", "减脂"], "max_results": 50, "media_max_items": 5}

这里的 5 是本次运行全部关键词共享的视频选择上限，不是每词 5 个，也不是保证交付数量。 仅最终符合条件的 VIDEO 内容可下载；可用时提供无抖音平台水印的文件， 但不保证每个视频都能下载或无水印。下载失败不撤销已接受的元数据。

运行结束后，在默认 Dataset 查看或导出结构化结果；默认键值存储中的 OUTPUT 记录状态、数量和限制。请求媒体时，查看 MEDIA_MANIFEST 中的交付或不可用结果， 成功文件位于同一存储的 MEDIA_<aweme_id>.mp4，保留期限取决于存储设置。

免费测试版不收取额外开发者/提供方费用。Apify 运行、存储和传输费用仍适用， 即使结果少于预期；下载 MP4 可能增加费用和耗时。 无需抖音账号或导入 Cookie。不保证结果数量、完整覆盖、相关性或最新排序、固定速度或 SLA； 测试版容量可能暂时不可用，多词 Dataset 序列化大小上限为 32 MiB。 创作者计数和互动数据来自帖子中的公开信息，未经独立核实；不支持私密数据、 完整主页/历史抓取或可选排序筛选。使用者仍须遵守隐私、版权及适用法律和平台规则。

Responsible use

Public creator information, including names, handles, identifiers such as authorSecUid, verification status and public counters, can still be personal data. You are responsible for complying with applicable laws, privacy and data-protection obligations, and Douyin's applicable terms and policies.

A downloadable MP4 does not grant rights to reuse or republish it. You are responsible for copyright and other applicable rights when storing, redistributing or republishing media.

This is an independent, unofficial tool. It is not affiliated with, sponsored by, endorsed by or operated by Douyin or ByteDance. Their names and trademarks are used only to identify the supported platform.