# 今日头条 API

围绕指定头条账号检索文章、视频与动态，读取内容正文和作者资料，按文章或视频链接读取评论；保留阅读、播放等指标。

- Domain: social · 6 data actions
- Canonical page: https://everyinfra.com/toutiao-api
- Failures and empty results never form a final charge.

## Actions

### article — 文章详情
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: url

- Returns fields: id, url, type, title, text, content_text, cover, read_count, play_count, like_count, comment_count, share_count, source, author_name, author_id, author_verified, author_auth_info, region, posted_at, platform, duration_sec, duration_seconds, image_urls

### profile — 主页或对象详情
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: user_id

- Returns fields: user_id, nickname, bio, url, avatar_url, is_verified, verify_reason, platform

### user_posts — 用户内容
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: user_id

- Optional: tab

- Returns fields: id, url, type, title, text, content_text, cover, read_count, play_count, like_count, comment_count, share_count, source, author_name, author_id, author_verified, author_auth_info, region, posted_at, platform, duration_sec, duration_seconds, image_urls

### profile_search — 账号搜索
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: user_id, keyword

- Returns fields: id, url, type, title, text, content_text, cover, read_count, play_count, like_count, comment_count, share_count, source, author_name, author_id, author_verified, author_auth_info, region, posted_at, platform, duration_sec, duration_seconds, image_urls

### comments — 评论
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: url

- Optional: page_token

- Returns fields: id, text, like_count, reply_count, posted_at, author_id, author_name, author_avatar_url, author_verified, author_auth_info, ip_location, liked_by_author, platform

### video — 视频详情
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: url

- Returns fields: id, url, video_type, title, duration_sec, duration_seconds, play_count, like_count, comment_count, share_count, collect_count, impression_count, posted_at, cover_url, video_url, author_id, author_name, author_avatar_url, author_follower_count, author_verified, author_auth_info, platform

## Also

- Machine catalog (no key): https://everyinfra.com/openapi.json · GET /api/v1/social/catalog
- Agents guide: https://everyinfra.com/agents.md