Toutiao Video Detail Scraper (今日头条视频详情)

Fetch full video details from Toutiao (今日头条) by video ID or share URL. Returns clean, structured data for each video: title, abstract, duration, play-stream qualities, like / comment / share / collect counts, cover frame, category tags, author info, and the canonical share URL. Optionally enriches each video with its top-level comments.

Unofficial. This Actor is not affiliated with, authorized, or endorsed by Toutiao (今日头条) or ByteDance. It is an independent tool that retrieves publicly available data via a third-party API. Use it in compliance with Toutiao's terms and all applicable laws; you are responsible for how you use the retrieved data.

What it does

• By ID or URL — give one or more Toutiao video IDs (a.k.a. group_id / gid, e.g. 7036185404340437511) or share URLs like https://m.toutiao.com/video/7036185404340437511/. The Actor extracts the ID and fetches the full detail for each.
• App or Web source — choose the App API (richest fields) or the Web API.
• Comments (optional) — fetch top-level comments for every scraped video.

Toutiao has no public search endpoint. To discover video IDs, use the xigua-video-search Actor — Toutiao and Xigua share the same ByteDance ID space, so the IDs it returns work directly here.

Input

Field	Type	Default	Description
groupIds	string[]	["7036185404340437511"]	Video IDs (group_id / gid) or m.toutiao.com/video/<id>/ URLs.
source	enum	app	app (richest fields) or web.
maxItems	integer	50	Max total videos to scrape.
includeComments	boolean	false	Also fetch top-level comments per video.
maxCommentsPerVideo	integer	20	Cap on comments per video when enabled.

Example input

{
  "groupIds": [
    "7036185404340437511",
    "https://m.toutiao.com/video/7036185404340437511/"
  ],
  "source": "app",
  "maxItems": 50,
  "includeComments": true,
  "maxCommentsPerVideo": 10
}

Output

One dataset item per video:

{
  "groupId": "7036185404340437511",
  "gid": "7036185404340437511",
  "videoId": "v02004g10000c6inhubc77ucdb117j10",
  "url": "https://m.toutiao.com/video/7036185404340437511/",
  "shareUrl": "https://m.toutiao.com/video/7036185404340437511/?app=news_article...",
  "articleUrl": "https://toutiao.com/group/7036185404340437511/",
  "displayUrl": "https://toutiao.com/group/7036185404340437511/",
  "title": "全家一起品尝麻辣海鲜汤，软嫩蟹肉搭配美味鱼饼，味道鲜美无比！",
  "abstract": "和爸妈一起吃美味海鲜，汤香美味...",
  "tag": "video_food",
  "categories": ["video_food"],
  "hasVideo": true,
  "videoType": "video",
  "videoDuration": 1175,
  "videoProportion": 1.7777,
  "coverUrl": "https://p3-sign...",
  "diggCount": 12049,
  "commentCount": 1010,
  "shareCount": 593,
  "buryCount": 1,
  "repinCount": 1226,
  "readCount": 1450943,
  "impressionCount": 18201023,
  "publishTime": 1638266400,
  "isOriginal": true,
  "author": { "name": "兴森一家", "userId": "...", "verified": true, "verifyReason": "知名美食领域创作者" },
  "videoPlayInfo": { "status": 10, "video_id": "..." },
  "source": "app:7036185404340437511",
  "comments": []
}

Notes

• Data is sourced live; Toutiao occasionally rate-limits, so the Actor retries transient blocks with exponential backoff.
• videoPlayInfo is returned by Toutiao as a JSON string of stream qualities; the Actor parses it into a nested object when possible.
• Video IDs are de-duplicated within a run.