Douyin 抖音 Search Scraper: Videos by Keyword avatar

Douyin 抖音 Search Scraper: Videos by Keyword

Pricing

from $3.99 / 1,000 search results

Go to Apify Store
Douyin 抖音 Search Scraper: Videos by Keyword

Douyin 抖音 Search Scraper: Videos by Keyword

Search Douyin (抖音) by keyword without a login and get the videos and photo posts in Douyin's order, with rank, likes, comments, shares, the author, music, hashtags, search suggestions and direct MP4 links. Many keywords per run. Pay only for results.

Pricing

from $3.99 / 1,000 search results

Rating

0.0

(0)

Developer

TheShark

TheShark

Maintained by Community

Actor stats

0

Bookmarked

3

Total users

2

Monthly active users

6 days ago

Last modified

Features

Limited permissions

Share

Search Douyin (抖音, the Chinese TikTok) by keyword and get the matching videos and photo posts in Douyin's own order. Every result comes with its rank and full details: likes, comments, shares and saves, the author, music, hashtags and topic tags, search suggestions, every video quality with direct MP4 links, covers and more.

No Douyin account, login, cookies or proxies of your own are needed. You pay only for videos that were collected.

What can you do with Douyin Search Scraper?

  • Research a market or trend: what Douyin shows for your keywords and how well it performs.
  • Find creators: authors of the top videos for a topic, with their followers.
  • Track rankings: the position of videos for a keyword over time (search_rank).
  • Collect content: captions, hashtags, music and direct MP4 links.
  • Use it as a Douyin API: start runs and get results from your own code through the Apify API.
DataFields
Searchkeyword, rank
PostID, link, caption, date, duration, type (video or photo post)
Engagementlikes, comments, shares, saves
Authornickname, Douyin ID, sec_uid, verification, avatar
Videoplay, download, H.264 and H.265 links, every quality, covers, long-lived links
Music, tagsmusic with MP3 link, hashtags, mentions, Douyin's topic tags, search suggestions

How to search Douyin

  1. Enter keywords, one per line. Chinese keywords match best (e.g. 猫咪, 露营装备).
  2. Set Max videos per keyword.
  3. Click Start. Rows appear in the dataset in Douyin's order, with keyword and search_rank.
  4. Download the results as JSON, CSV, Excel or HTML, or get them through the API.

Input

FieldDescription
Search keywordsWhat to search for, one keyword or phrase per line.
Max videos per keywordStop after this many videos for each keyword (up to 1,000).
{
"keywords": ["猫咪", "露营装备"],
"maxResults": 100
}

Output

One row per video, in Douyin's search order. Nested objects are always present (empty values when Douyin has no data), so every row has the same columns.

Post

FieldDescription
aweme_idDouyin post ID.
keywordThe keyword this result was found for.
search_rankPosition in Douyin's results for that keyword (1 = first).
urlCanonical link: https://www.douyin.com/video/<id> (or /note/<id> for photo posts).
share_urlDouyin's share link (tracking query removed).
post_typevideo or images (photo/slideshow post).
aweme_typeDouyin's raw post type (0 = video, 68 = photo post, others exist).
media_typeDouyin's raw media type (4 = video, 2 = images).
descFull description, including hashtags.
captionCaption text as Douyin stores it separately (may be empty).
item_titleTitle (long videos usually have one; may be empty).
create_timePublish time, unix seconds.
create_time_isoPublish time, ISO 8601 UTC.
regionRegion code Douyin attaches to the post (often empty).
is_topPinned on the author's profile.
is_aigcDouyin labels the post (or one of its pictures) as generated content.
is_adsThe post is a paid ad.
danmaku_countBullet-comment (弹幕) count — 0 in search results (not in the search payload).
durationDuration in milliseconds (0 for photo posts).
oktrue for a successful row.

Statistics

FieldDescription
statistics.digg_countLikes.
statistics.comment_countComments.
statistics.share_countShares.
statistics.collect_countFavourites (收藏).
statistics.recommend_countRecommendations (推荐). Usually 0 in search results (Douyin's search payload omits it).
statistics.admire_countDouyin's "admire" (赞赏) counter. Usually 0 on the web.
statistics.play_countViews. Usually 0: Douyin hides view counts on the web (they are app-only). A 0 does not mean nobody watched.

Author

FieldDescription
author_sec_uidAuthor's sec_uid (same as author.sec_uid).
author.uidNumeric user ID.
author.sec_uidStable public user ID used in profile URLs.
author.unique_idThe @handle (Douyin ID); empty when the user never set one.
author.short_idLegacy numeric Douyin ID (empty when not set).
author.nicknameDisplay name.
author.signatureBio.
author.avatar_thumbAvatar image URL.
author.follower_countFollowers. Usually 0 in search results — use the Douyin Profile Scraper for real counts.
author.following_countFollowing (Douyin often reports 0 here).
author.total_favoritedTotal likes the author has received. Usually 0 in search results.
author.favoriting_countLikes the author has given.
author.custom_verifyVerification text (e.g. a creator badge).
author.enterprise_verify_reasonBusiness verification text.
author.verification_typeDouyin verification type code.
author.cover_urlThe author's profile banner image URL.

Video file

FieldDescription
video_play_addrMain playback MP4 URL (empty for photo posts).
video.play_addr_h264H.264 MP4 URL. Empty when Douyin serves the video only as H.265; video_play_addr always works.
video.play_addr_265H.265/HEVC MP4 URL (smaller files, when available).
video.download_addrDouyin's "download" rendition (may carry a watermark).
video.widthSource width in pixels.
video.heightSource height in pixels.
video.ratioDouyin's ratio/quality label.
video.coverCover image URL.
video.origin_coverOriginal cover image URL.
video.dynamic_coverAnimated cover URL.
video.cdn_url_expiredUnix time when the video URLs above stop working.
video.play_url_stableLong-lived link to the same video as video_play_addr (an api.amemv.com/aweme/v1/play/-style URL). It redirects to a fresh CDN copy, so it keeps working after the direct links expire (still served the video 15 hours after capture; Douyin does not publish its lifetime). No cookies or headers needed. Empty for photo posts.
video.formatDouyin's preferred web delivery format (e.g. dash). It does not describe video_play_addr, which is always a complete MP4 with sound.
video.download_url_stableLong-lived link to video.download_addr, same behaviour as video.play_url_stable.
video.has_watermarkDouyin's flag that a watermarked rendition exists.
video.is_long_videoDouyin classifies the video as long-form.
video.bit_rate[]Every available quality (both mp4 and dash renditions), each with:
video.bit_rate[].gear_nameQuality name (e.g. normal_1080_0).
video.bit_rate[].quality_typeDouyin quality code.
video.bit_rate[].formatmp4 = complete file with sound. dash = video-only stream for adaptive players (no audio track) — pick an mp4 row to download a watchable file.
video.bit_rate[].bit_rateBitrate, bits per second.
video.bit_rate[].is_h265H.265 encoded.
video.bit_rate[].fpsFrames per second.
video.bit_rate[].widthWidth in pixels.
video.bit_rate[].heightHeight in pixels.
video.bit_rate[].data_sizeFile size, bytes.
video.bit_rate[].urlDirect URL for this quality (expires with video.cdn_url_expired).
video.bit_rate[].url_stableLong-lived link to this quality (redirects to a fresh CDN copy).
video.bit_rate_audio[]Audio-only DASH streams (AAC in fragmented MP4). Pair one with a dash video quality to build a full file (e.g. ffmpeg -i video -i audio -c copy out.mp4). Each with:
video.bit_rate_audio[].bitrateBitrate, bits per second.
video.bit_rate_audio[].formatDelivery format (DASH).
video.bit_rate_audio[].codec_typeCodec label as Douyin sends it — not reliable for audio (it can read like a video codec while the stream is AAC).
video.bit_rate_audio[].qualityDouyin quality label.
video.bit_rate_audio[].sizeStream size, bytes.
video.bit_rate_audio[].urlDirect URL (expires like the other CDN links).
video.bit_rate_audio[].url_stableLong-lived link to this audio stream.

Photo posts

FieldDescription
images[]The pictures of a photo post (empty for videos), each with:
images[].urlImage URL.
images[].download_urlDouyin's download rendition (watermarked).
images[].widthWidth in pixels.
images[].heightHeight in pixels.
images[].is_aigcDouyin labels this picture as generated content.

Music

FieldDescription
music_titleMusic title (same as music.title).
music.idMusic ID.
music.titleTitle.
music.authorArtist / creator name.
music.owner_idUser ID of the music's owner.
music.owner_nicknameOwner's display name.
music.durationDuration in seconds.
music.is_original_soundThe track is the creator's original sound.
music.play_urlMP3 URL.
music.cover_largeMusic cover URL.
music.albumAlbum name (often empty).
music.owner_handleThe @handle of the music's owner.
music.is_commerce_musicLicensed commercial music from Douyin's library.
music.is_pgcProfessionally produced music (label/PGC), not a user's original sound.

Hashtags, mentions, tags

FieldDescription
hashtags[]Creator-typed hashtags, each with:
hashtags[].hashtag_idHashtag (challenge) ID.
hashtags[].hashtag_nameHashtag text without #.
mentions[]@mentions in the description, each with:
mentions[].textThe mention as written (e.g. @name).
mentions[].uidMentioned user's numeric ID.
mentions[].sec_uidMentioned user's sec_uid.
video_tags[]Douyin's own 3-level topic classification (e.g. 美食 → 美食探店 → 餐厅探店), each with:
video_tags[].tag_idTag ID.
video_tags[].tag_nameTag name.
video_tags[].level1, 2 or 3.

Collection and location

FieldDescription
mix.mix_idCollection (合集 / series) ID, empty when the post is not in one.
mix.mix_nameCollection name.
mix.current_episodeThis post's episode number in the collection.
mix.updated_to_episodeEpisodes published so far.
poi.poi_idTagged location (POI) ID, empty when none.
poi.poi_nameTagged location name.

Products (小黄车 shopping cards)

FieldDescription
products[]Products the creator attached to the post (empty when none). Each with:
products[].product_idDouyin shop product ID (stable).
products[].promotion_idPromotion ID the card links to.
products[].titleFull product title.
products[].elastic_titleShort title shown on the card.
products[].salesUnits sold, as shown on the card.
products[].comment_countProduct reviews.
products[].coverProduct image URL.
products[].urlProduct page on Douyin's shop (ecom.douyin.com).
products[].shop_idSeller's shop ID.
products[].goods_sourceWhere the product comes from (e.g. 来自小店 = a Douyin shop).
products[].category_names[]Category path, top-down (e.g. 服装 → 女装 → 其他套装).
products[].tags[]Card tags (shipping promise, review count…).

Chapters, summary and search suggestions

FieldDescription
chapters[]Video chapters — the creator's own, or Douyin's automatic ones (see chapter_source). Each with:
chapters[].titleChapter title.
chapters[].detailChapter description (may be empty).
chapters[].timestamp_msChapter start, milliseconds.
chapters[].coverChapter thumbnail URL (creator chapters only).
chapter_source"creator", "auto" (chapters Douyin made itself) or empty when the video has none.
chapter_abstractDouyin's own summary of the whole video, when there is one.
suggest_words[]The "大家都在搜" (people also search) queries Douyin shows under the post — real search demand around the video. Each with:
suggest_words[].wordThe search query.
suggest_words[].word_idDouyin ID of the query.
suggest_words[].sceneWhere Douyin shows it (e.g. above the comments).
FieldDescription
series.series_idSeries ID (empty when the post is not in a series; often the same as mix.mix_id).
series.series_nameSeries name as Douyin shows it.
series.episodeThis post's episode number.
series.total_episodeEpisodes in the series.
series.total_durationWhole series duration, seconds.
series.item_pricePrice as Douyin reports it (0 = free).
series.is_paidThe series is a paid one.

Permissions and status

FieldDescription
permissions.allow_downloadViewers may download the video in the app.
permissions.allow_duetDuets (合拍) allowed.
permissions.allow_stitchStitching allowed.
permissions.allow_shareSharing allowed.
permissions.allow_commentComments open.
permissions.allow_record"Use this sound / shoot the same" allowed.
status.private_status0 = public; other values = restricted visibility.
status.in_reviewingUnder Douyin review.
status.is_prohibitedRestricted by Douyin.

Row statuses

RowMeaningCharged?
ok: trueThe keyword was collected.Yes
ok: falseThe keyword was not collected. error and reason say why: BlockedOrGone means Douyin did not return this keyword; for any other value, run it again later.No
error: "Skipped"The run did not get to this input. Run it again.No

Rows with ok: false carry the keyword. A keyword with no matches gets one free row with keyword, results: 0 and ok: true. When only part of a keyword's results came through, the collected videos stay in the dataset and its ok: false row gives their number in results.

How much does it cost to search Douyin?

The actor uses pay-per-event pricing: a flat price per collected video and a small fee per run start. The current prices are on the Pricing tab. There is no extra fee per keyword.

EventWhen it is charged
ResultOne video or photo post collected (ok: true).
Actor startOnce per run.

You pay only for what was delivered:

  • Only rows with data are charged. Rows with ok: false are free.
  • Set a maximum cost per run in Apify and the actor stops cleanly when it is reached, keeping everything collected so far.
  • Nothing is charged twice in one run, even if Apify restarts or migrates the run.

Good to know

  • About 100–160 videos per keyword is what Douyin's search shows; set Max videos per keyword lower to save cost.
  • Douyin's order. Results come in the order Douyin ranks them; there are no sort or date filters.
  • View counts. Douyin does not show view counts on its website, so statistics.play_count is usually 0. Use statistics.recommend_count, likes, comments, shares and saves to compare reach.
  • Links that keep working. Media links are signed CDN links that expire (see video.cdn_url_expired). The *_stable links (video.play_url_stable, video.download_url_stable, video.bit_rate[].url_stable, video.bit_rate_audio[].url_stable) redirect to a fresh copy of the same file, so store those.
  • Qualities. dash entries in video.bit_rate[] are video-only tracks; mp4 entries and video_play_addr include sound.
  • Products. products[] lists the shopping cards (小黄车) attached to a video, with title, sales, shop and category. Prices are not part of Douyin's public web data.
  • Location. poi.poi_id and poi.poi_name are filled when Douyin includes the location in the post.
  • Photo posts have post_type: "images", the pictures in images[] and no video links; their background music is in music.play_url.
  • Data is in Chinese, exactly as Douyin shows it.
  • Public data only. The actor collects what anyone can see on douyin.com without an account.

Integrations and API

  • API: start runs and download results with the Apify API or the Apify clients for Python and JavaScript.
  • Schedules: run the actor every hour, day or week and keep the numbers fresh.
  • Integrations: send results to Google Sheets, Slack, Make, Zapier, webhooks and other tools supported by Apify.

FAQ

Do I need a Douyin account or proxies? No. The actor does not log in and uses its own proxies.

Which language should I search in? Chinese keywords give the best matches, as on Douyin itself. English and brand names work too.

Is the output the same as Douyin Video Scraper? Yes. Rows have the same fields, plus keyword and search_rank.

Do I pay for videos that were not collected? No. Only rows with data are charged.