Xigua video search scraper: keyword search for Chinese video data

Get Xigua (西瓜视频) video results by keyword or hashtag, with play counts, likes, author profiles, and cover images, ready for your spreadsheet in minutes.

What does this actor do?

Xigua Video is one of China's largest long-form video platforms with over 300 million users, operated by ByteDance. This actor searches it by keyword or hashtag and returns a structured dataset of matching videos, including engagement metrics, author details, and direct video URLs.

Each run delivers:

• Video titles, categories, durations, and publish dates
• Play counts, like counts, share counts, and comment counts
• Author name, follower count, avatar URL, and channel description
• Direct video page URL and high-resolution cover image URL
• Optional deep detail extraction for playback stream links (fetchVideoDetails)

Who uses this actor?

• I am a brand intelligence analyst monitoring how Chinese consumers discuss travel, food, and tech categories on Xigua so I can compile quarterly trend reports for my marketing leadership.
• I am a content strategist at a media agency tracking which video topics dominate Xigua search results in target niches so I can identify content gaps and inform our brand's cross-market editorial calendar.
• I am an influencer marketing manager gathering follower counts and video engagement data for Xigua creators in specific categories so I can benchmark brand deal rates in the Chinese market before approaching partners.
• I am an e-commerce seller identifying which product demonstration and unboxing videos are gaining traction on Xigua so I can time my inventory orders before demand spikes reach Western platforms.

Data table

Field	Type	Description
entityType	string	Always video.
query	string	The search keyword used to find this result.
searchType	string	keyword or hashtag, depending on input.
groupId	string	Unique video identifier on the platform.
title	string	Video title with emphasis formatting removed.
abstract	string	Short video summary or description text.
videoDurationSecs	number	Video length in seconds.
publishTimeIso	string	Publish date and time in ISO 8601 format.
videoUrl	string	Direct URL to the video page on Xigua.
playCount	number	Total play count reported by the platform.
commentCount	number	Total comment count reported by the platform.
diggCount	number	Like count (digg) for the video. Null if not available.
shareCount	number	Share count for the video. Null if not available.
buryCount	number	Dislike count for the video. Null if not available.
isOriginal	boolean	Whether the video is marked as original content. Null if not reported.
authorName	string	Creator's display name or channel name.
authorId	string	Unique numerical user ID of the creator.
authorAvatar	string	URL to the creator's profile avatar image.
authorFollowers	number	Creator's follower count. Null if not available.
authorDescription	string	Creator's channel bio or signature text.
coverUrl	string	URL to the high-resolution video cover image.
videoCategoryName	string	Category name assigned to the video on Xigua.
playback	object	Playback stream metadata including variants. Populated when fetchVideoDetails is enabled.
scrapedAt	string	Timestamp when this record was extracted, in ISO 8601 format.

Sample output record

{
  "entityType": "video",
  "query": "旅行",
  "searchType": "keyword",
  "groupId": "7341892340123456789",
  "title": "一个人的西藏之旅：14天骑行全程真实记录",
  "abstract": "一个人的西藏之旅：14天骑行全程真实记录",
  "videoDurationSecs": 1847,
  "publishTimeIso": "2026-04-15T08:23:00.000Z",
  "videoUrl": "https://www.ixigua.com/7341892340123456789",
  "playCount": 4280000,
  "commentCount": 12300,
  "diggCount": 89400,
  "shareCount": 23100,
  "buryCount": 142,
  "isOriginal": true,
  "authorName": "骑行达人阿峰",
  "authorId": "5693412870",
  "authorAvatar": "https://p3.ixigua.com/tos-cn-avt-0015/6930884702659584.image",
  "authorFollowers": 280000,
  "authorDescription": "环游中国摩托骑行博主",
  "coverUrl": "https://p3.ixigua.com/tos-cn-i-qvj2lq49k0/cover_7341892340123456789_large.jpg",
  "videoCategoryName": "旅行",
  "scrapedAt": "2026-06-29T14:45:12.000Z"
}

Input

Field	Type	Required	Description
queries	array	Yes	Keywords or hashtags to search. Each entry runs as a separate, independent search (e.g. 旅行, 美食, #搞笑).
searchType	enum	No	How queries are interpreted: auto detects # prefix, keyword forces keyword mode, hashtag forces hashtag mode.
maxResultsPerQuery	integer	No	Maximum videos to retrieve per keyword. Accepts values from 1 to 1,000.
sortBy	enum	No	Result ordering: relevance (default), newest for most recently published, or mostPlayed for highest play count.
duration	enum	No	Filter by video length: any, under3m, 3to5m, 5to10m, 10to30m, 30to60m, or over60m.
fetchVideoDetails	boolean	No	When enabled, visits each video page to extract MP4 stream URLs and richer engagement data. Increases cost per result. Disabled by default.
proxyConfiguration	proxy	Yes	Proxy settings. A mainland China residential proxy is pre-selected and required to access regional content.

Pricing

This actor uses pay-per-result pricing. You are charged only when a video record is successfully delivered to your dataset. Empty runs and failed requests cost nothing. There are no monthly subscriptions, platform fees, or minimum commitments.

FAQ

Can I search Xigua without a Chinese account or VPN? Yes. The actor handles regional access through its built-in proxy settings. No account, login, or personal VPN is required.

How many results can I get per keyword? Up to 1,000 videos per keyword. Use maxResultsPerQuery to set the exact limit per run.

Does the actor return video download links? By default it returns the canonical video page URL for each result. Enable fetchVideoDetails in the input to attempt extraction of direct playback stream URLs. Availability depends on the video's settings on Xigua.

Can I search hashtag pages, not just keyword searches? Yes. Prefix any query with # (e.g. #旅行) or set searchType to hashtag to switch to hashtag search mode.