# X (Twitter) API

以关键词或账号 handle 检索 X 帖子，读取个人资料、单帖和会话回复样本，保留原文链接及互动计数，供讨论观察与内容整理使用。

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

## Actions

### search — 关键词搜索
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: keyword

- Optional: sort

- Returns fields: id, url, text, like_count, retweet_count, reply_count, view_count, posted_at, author_username, author_name, author_url, author_follower_count, quote_count, bookmark_count, language, conversation_id, is_reply, is_quote, is_repost, is_pinned, reply_to_id, reply_to_user_id, reply_to, source, media, hashtags, mentions, links, author_id, author_avatar_url, author_bio, author_is_verified, author_following_count, author_post_count, author_media_count, author_created_at, author_banner_url, platform

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

- Returns fields: user_id, username, display_name, bio, url, follower_count, following_count, post_count, is_verified, location, avatar_url, created_at, platform

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

- Returns fields: id, url, text, like_count, retweet_count, reply_count, view_count, posted_at, author_username, author_name, author_url, author_follower_count, quote_count, bookmark_count, language, conversation_id, is_reply, is_quote, is_repost, is_pinned, reply_to_id, reply_to_user_id, reply_to, source, media, hashtags, mentions, links, author_id, author_avatar_url, author_bio, author_is_verified, author_following_count, author_post_count, author_media_count, author_created_at, author_banner_url, platform

### post — 单条内容
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: id

- Optional: tweet_id

- Returns fields: id, url, text, like_count, retweet_count, reply_count, view_count, posted_at, author_username, author_name, author_url, author_follower_count, quote_count, bookmark_count, language, conversation_id, is_reply, is_quote, is_repost, is_pinned, reply_to_id, reply_to_user_id, reply_to, source, media, hashtags, mentions, links, author_id, author_avatar_url, author_bio, author_is_verified, author_following_count, author_post_count, author_media_count, author_created_at, author_banner_url, platform

### comments — 评论
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: id

- Optional: tweet_id

- Returns fields: id, url, text, like_count, retweet_count, reply_count, view_count, posted_at, author_username, author_name, author_url, author_follower_count, quote_count, bookmark_count, language, conversation_id, is_reply, is_quote, is_repost, is_pinned, reply_to_id, reply_to_user_id, reply_to, source, media, hashtags, mentions, links, author_id, author_avatar_url, author_bio, author_is_verified, author_following_count, author_post_count, author_media_count, author_created_at, author_banner_url, platform

### trending — 热榜
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: —

- Optional: country

- Returns fields: id, name, rank, volume, period, collected_at, platform

### followers_list — 粉丝列表
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: username

- Returns fields: id, username, url, name, text, location, avatar_url, follower_count, following_count, post_count, is_verified, is_protected, created_at, platform

### following_list — 关注列表
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: username

- Returns fields: id, username, url, name, text, location, avatar_url, follower_count, following_count, post_count, is_verified, is_protected, created_at, platform

### user_media — 媒体帖子
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: username

- Optional: page_token

- Returns fields: next_page_token, id, url, text, like_count, retweet_count, reply_count, view_count, posted_at, author_username, author_name, author_url, author_follower_count, quote_count, bookmark_count, language, conversation_id, is_quote, is_repost, is_pinned, source, media, author_id, author_bio, author_is_verified, author_following_count, author_post_count, author_media_count, author_created_at, author_banner_url, platform

### user_replies — 回复帖子
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: username

- Optional: page_token

- Returns fields: next_page_token, id, url, text, like_count, retweet_count, reply_count, view_count, posted_at, author_username, author_name, author_url, author_follower_count, quote_count, bookmark_count, language, conversation_id, is_reply, is_quote, is_repost, is_pinned, reply_to_id, media, hashtags, mentions, links, author_id, author_avatar_url, author_bio, author_is_verified, author_following_count, author_post_count, author_media_count, author_created_at, author_banner_url, platform

### retweeters — 转推用户
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: id

- Optional: page_token, url

- Returns fields: media_count, next_page_token, id, username, url, name, text, follower_count, following_count, post_count, platform

### profiles_by_ids — 按 ID 批量查资料
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: user_ids

- Returns fields: user_id, username, display_name, url, location, is_verified, is_protected, affiliation, avatar_url, created_at, account_status, platform

### user_about — 账号所在地与改名记录
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: username

- Returns fields: user_id, username, display_name, url, account_based_in, is_location_accurate, signup_source, username_change_count, last_username_change_at, is_verified, verified_since, is_protected, affiliation, avatar_url, account_status, platform

### check_follow — 是否关注
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: username, target_username

- Returns fields: username, target_username, is_following, platform

### check_retweet — 是否转推
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: username, id

- Optional: url

- Returns fields: username, post_id, is_retweeted, platform

### community_info — 社群资料
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: community_id

- Optional: url

- Returns fields: id, url, name, description, topic, member_count, is_nsfw, banner_url, created_at, rules, platform

### search_communities — 社群搜索
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: keyword

- Optional: page_token

- Returns fields: id, url, name, topic, member_count, is_nsfw, banner_url, platform, next_page_token

### search_users — 用户搜索
- Mode: sync · Price: 40 credits ($0.56 / 千次)
- Required: keyword

- Optional: page_token

- Returns fields: next_page_token, id, username, url, name, text, avatar_url, follower_count, following_count, post_count, is_verified, created_at, platform

### video_transcript — 视频口播文稿
- Mode: sync · Price: 69 credits ($0.96 / 千次)
- Required: url

- Optional: id

- Returns fields: id, url, text, word_count

### thread — 推文自串
- Mode: sync · Price: 155 credits ($2.15 / 千次)
- Required: url

- Optional: id

- Returns fields: id, url, text, like_count, retweet_count, reply_count, view_count, posted_at, author_username, author_name, author_url, author_follower_count, quote_count, bookmark_count, language, conversation_id, is_reply, reply_to_id, source, media, author_id, author_avatar_url, author_bio, author_is_verified, author_following_count, author_created_at, author_banner_url, platform

### community_posts — 社群帖子
- Mode: sync · Price: 58 credits ($0.81 / 千次)
- Required: community_id

- Optional: page_token, url

- Returns fields: next_page_token, id, url, text, like_count, retweet_count, reply_count, view_count, posted_at, author_username, author_name, author_url, quote_count, language, is_quote, is_repost, is_pinned, source, media, author_id, author_is_verified, platform

## Also

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