游标分页推特高级搜索 (Twitter Scraper API)

基于游标（Cursor）分页的推特高级搜索与实时推文抓取接口。官方 X API 高性价比平替，无需维护 Cookie、代理池或浏览器环境即可大批量提取推文。支持关键词、高级布尔语法、作者、话题与时间范围过滤。每页返回最多 20 条推文，配合 next_cursor 即可实现长流式稳定抓取。单价低至 $0.05 / 1,000 条推文。

返回 API 接口列表

/Search Endpoints

TwexAPI REST

POST/twitter/advanced_search/page

API 鉴权

AuthorizationBearer token · header必填

TwexAPI 平台的全局身份凭据 (Bearer Token)。所有接口调用均需在 Header 中携带：Authorization: Bearer <YOUR_TWEXAPI_KEY>。可在 TwexAPI 用户控制台获取。

请求体

必填application/json

searchTermsstring[]必填

要检索的推特搜索词语法数组。可在 [Advance Search TwitterXAPI](https://advance-search.pages.dev) 在线可视化生成高级搜索语法。

sortBystring必填

搜索结果排序方式：'Latest'（最新）或 'Top'（热门）

default: "Latest"

允许值:LatestTop

next_cursorstring | any

用于拉取下一页数据的游标（Cursor）。当 has_next_page 为 true 时将此值作为下一页的 cursor 参数传入

展开属性

Any of:

string

string

any

any

响应结果

200当前页推文动态（最多 20 条）及分页元数据（has_next_page, next_cursor）。

codeinteger

HTTP 响应状态码（200 表示成功）

default: 200

msgstring

响应提示信息（例如 'success'）

default: "success"

dataTweetModel | any[]必填

接口返回的核心业务数据载荷

展开属性

Array of TweetModel | any

Any of:

TweetModel

tweet_idstring必填

推文唯一数字 ID

is_paid_promotionboolean | any

标记该推文正文或作者是否涉及付费推广/商业赞助

default: false

展开属性

Any of:

boolean

boolean

any

any

textstring必填

文本正文内容

created_atstring | any

发布或创建时间（UTC 标准时间格式）

展开属性

Any of:

string

string

any

any

created_at_datetimestring | any

推文创建发布时间的 ISO 8601 标准时间字符串

展开属性

Any of:

string

string

any

any

bookmark_countinteger | any

推文被用户加入书签收藏的累计次数

default: 0

展开属性

Any of:

integer

integer

any

any

bookmarkedboolean | any

标记当前操作账号是否已将此推文加入书签收藏

default: false

展开属性

Any of:

boolean

boolean

any

any

community_notestring | any

与该推文关联的推特社区大众附注（Community Note）

展开属性

Any of:

string

string

any

any

edit_tweet_idsstring[]

该推文历次编辑历史对应的推文 ID 列表

default: []

editable_until_msecsstring | any

推文截止允许二次编辑修改的时间戳（毫秒）

展开属性

Any of:

string

string

any

any

edits_remainingstring | any

该推文剩余允许编辑修改的次数

展开属性

Any of:

string

string

any

any

favorite_countinteger | any

推文获赞（Favorite/Like）累计总数

default: 0

展开属性

Any of:

integer

integer

any

any

favoritedboolean | any

标记当前操作账号是否已给此推文点赞

default: false

展开属性

Any of:

boolean

boolean

any

any

full_textstring | any

推文的完整正文文本

展开属性

Any of:

string

string

any

any

has_cardboolean | any

标记该推文是否附带网页富链接卡片（Twitter Card）

default: false

展开属性

Any of:

boolean

boolean

any

any

has_community_notesboolean | any

标记该推文是否被添加了社区附注（Community Notes）

default: false

展开属性

Any of:

boolean

boolean

any

any

hashtagsstring[]

推文中包含的 Hashtag 话题标签列表

default: []

cashtagsstring[]

推文中提及的 Cashtag 金融代号列表

default: []

idstring | any

推文的唯一数字标识 ID（等同于 tweet_id）

展开属性

Any of:

string

string

any

any

in_reply_tostring | any

被回复的目标推文 ID

展开属性

Any of:

string

string

any

any

in_reply_to_user_idstring | any

被回复的目标推特用户 ID

展开属性

Any of:

string

string

any

any

in_reply_to_screen_namestring | any

被回复的目标作者推特用户名（Handle）

展开属性

Any of:

string

string

any

any

is_edit_eligibleboolean | any

标记该推文当前是否仍具备二次编辑修改资格

default: false

展开属性

Any of:

boolean

boolean

any

any

is_quote_statusboolean | any

标记该推文是否为带评论的引用推文（Quote Tweet）

default: false

展开属性

Any of:

boolean

boolean

any

any

quoted_status_id_strstring | any

被引用的目标推文唯一数字 ID

展开属性

Any of:

string

string

any

any

is_translatableboolean | any

标记该推文是否支持推特官方机器翻译功能

default: false

展开属性

Any of:

boolean

boolean

any

any

langstring | any

推文主要语言代码（如 'zh', 'en', 'ja' 等）

展开属性

Any of:

string

string

any

any

mediaMediaModel[]

随推文附带的多媒体附件对象列表（照片、视频）

default: []

展开属性

Array of MediaModel

idstring必填

推特媒体文件唯一资产 ID（Media ID）

typestring必填

媒体附件类型（例如 photo 照片、video 视频）

display_urlstring | any

用于在前端卡片中渲染展示的媒体公开 URL

展开属性

Any of:

string

string

any

any

expanded_urlstring | any

媒体文件的完整展开 URL

展开属性

Any of:

string

string

any

any

media_urlstring | any

可选：随消息附带的公开图片或媒体附件 URL 地址

展开属性

Any of:

string

string

any

any

urlstring | any

推特官方分配给该媒体资源的 t.co 短链接

展开属性

Any of:

string

string

any

any

heightinteger | any

媒体附件的画面像素高度

展开属性

Any of:

integer

integer

any

any

widthinteger | any

多媒体附件的画面像素宽度

展开属性

Any of:

integer

integer

any

any

featuresobject | any

媒体附件的特殊功能属性

展开属性

Any of:

object

object

any

any

original_infoobject | any

多媒体附件的原始元数据信息

展开属性

Any of:

object

object

any

any

sizesobject | any

该媒体资源提供的可用分辨率尺寸规格

展开属性

Any of:

object

object

any

any

source_status_idstring | any

若本条推文属于转发，此处为源推文的 ID

展开属性

Any of:

string

string

any

any

source_user_idstring | any

若本条推文属于转发，此处为源推文作者的推特数字 ID

展开属性

Any of:

string

string

any

any

duration_millisinteger | any

视频媒体时长（单位：毫秒）

展开属性

Any of:

integer

integer

any

any

aspect_ratiointeger[] | any

视频附件的画面宽高比（例如 [16, 9]）

展开属性

Any of:

integer[]

Array of integer

integer

any

any

video_infoobject | any

推文视频附件的详细技术参数信息

展开属性

Any of:

object

object

any

any

streamsStreamModel[]

该视频可用的多种分辨率清晰度流列表

default: []

展开属性

Array of StreamModel

urlstring | any

视频分片或播放流的直接访问 URL

展开属性

Any of:

string

string

any

any

bitrateinteger | any

视频流的比特率码率（单位：bps）

展开属性

Any of:

integer

integer

any

any

content_typestring | any

媒体数据流的 Content-Type 格式（如 video/mp4）

展开属性

Any of:

string

string

any

any

placestring | any

发布推文时附加的地理位置信息对象

展开属性

Any of:

string

string

any

any

pollstring | any

推文中附带的投票组件详情

展开属性

Any of:

string

string

any

any

possibly_sensitiveboolean | any

标记该推文是否可能包含敏感或限制级内容

展开属性

Any of:

boolean

boolean

any

any

possibly_sensitive_editableboolean | any

标记该推文的敏感内容标记是否允许编辑

展开属性

Any of:

boolean

boolean

any

any

quoteTweetModel | any

被引用的原始推文完整对象

展开属性

Any of:

TweetModel

Circular reference to TweetModel.

any

any

quote_countinteger | any

推文被引用转发（Quote Tweet）的累计总数

default: 0

展开属性

Any of:

integer

integer

any

any

related_tweetsTweetModel[]

推荐的相关推文对象列表

default: []

展开属性

Array of TweetModel

Circular reference to TweetModel.

repliesTweetModel[]

对该推文的评论回复对象列表

default: []

展开属性

Array of TweetModel

Circular reference to TweetModel.

reply_countinteger | any

推文收到的评论回复总数

default: 0

展开属性

Any of:

integer

integer

any

any

reply_toTweetModel | any

被回复的上一级父推文对象

展开属性

Any of:

TweetModel

Circular reference to TweetModel.

any

any

retweet_countinteger | any

推文被转发的累计总数

default: 0

展开属性

Any of:

integer

integer

any

any

retweeted_tweetTweetModel | any

若本条属于转推，此处为被转发的原始推文对象

展开属性

Any of:

TweetModel

Circular reference to TweetModel.

any

any

threadTweetModel[] | any

推文所属的整个对话 Thread 的根推文 ID

展开属性

Any of:

TweetModel[]

Array of TweetModel

Circular reference to TweetModel.

any

any

thumbnail_titlestring | any

推特富文本卡片中缩略图的标题文本

展开属性

Any of:

string

string

any

any

thumbnail_urlstring | any

推特富文本卡片中缩略图的访问 URL

展开属性

Any of:

string

string

any

any

urlsstring[]

推文正文中包含的外部链接 URL 列表

default: []

userUserModel | any

发布该推文的作者用户资料卡

展开属性

Any of:

UserModel

idstring必填

用户唯一数字 ID

namestring必填

用户昵称/显示名称

screen_namestring必填

推特用户名（Handle，即 @ 后的名称）

created_atstring | any

发布或创建时间（UTC 标准时间格式）

展开属性

Any of:

string

string

any

any

created_at_datetimestring | any

ISO 8601 标准格式的账号注册时间

展开属性

Any of:

string

string

any

any

can_dmboolean | any

当前登录账号是否允许向该用户发送私信

default: false

展开属性

Any of:

boolean

boolean

any

any

can_media_tagboolean | any

他人发推附加图片或视频时是否允许 @ 圈出标记该用户

default: false

展开属性

Any of:

boolean

boolean

any

any

default_profileboolean | any

该用户是否依然使用推特官方默认资料模板

default: false

展开属性

Any of:

boolean

boolean

any

any

default_profile_imageboolean | any

该用户是否依然使用推特默认头像（初始蛋头图）

default: false

展开属性

Any of:

boolean

boolean

any

any

descriptionstring | any

个人主页 Bio 自我介绍文本

default: ""

展开属性

Any of:

string

string

any

any

description_urlsstring[]

在用户 Bio 自我介绍中发现的外部链接 URL 清单

default: []

urlsurlModel[] | any

在用户主页资料中填写的官网链接 URL 清单

展开属性

Any of:

urlModel[]

Array of urlModel

urlstring必填

URL

expanded_urlstring | any

还原后的完整网页跳转 URL

展开属性

Any of:

string

string

any

any

display_urlstring | any

推特卡片上对外展示的缩略 URL

展开属性

Any of:

string

string

any

any

any

any

fast_followers_countinteger | any

优质活跃粉丝数量

default: 0

展开属性

Any of:

integer

integer

any

any

favourites_countinteger | any

该账号历史点赞过的推文总数

default: 0

展开属性

Any of:

integer

integer

any

any

followers_countinteger | any

关注该账号的粉丝总数

default: 0

展开属性

Any of:

integer

integer

any

any

following_countinteger | any

该账号正在关注的账号总数

default: 0

展开属性

Any of:

integer

integer

any

any

has_custom_timelinesboolean | any

该用户主页是否配置了自定义推文聚合时间线

default: false

展开属性

Any of:

boolean

boolean

any

any

is_blue_verifiedboolean | any

是否为推特蓝 V 认证用户（X Premium 会员）

default: false

展开属性

Any of:

boolean

boolean

any

any

verified_typestring | any

推特非个人官方认证徽章类型（blue 蓝 V、business 企业金 V、government 政府灰 V 等）

展开属性

Any of:

string

string

any

any

is_verifiedboolean | any

当账号具备任何形式的官方认证徽章（个人蓝 V、机构金 V、政务灰 V 或经典认证）时为 true

default: false

展开属性

Any of:

boolean

boolean

any

any

profile_image_shapestring | any

用户头像裁切外观（Circle 圆形，Square 方形；方形通常代表官方企业机构或政务账号）

展开属性

Any of:

string

string

any

any

is_translatorboolean | any

该用户是否为推特官方多语言众包译者

default: false

展开属性

Any of:

boolean

boolean

any

any

listed_countinteger | any

该账号被收录进推特公开列表的次数

default: 0

展开属性

Any of:

integer

integer

any

any

locationstring | any

用户在个人主页填写的所在地/国家地区

default: ""

展开属性

Any of:

string

string

any

any

media_countinteger | any

该账号累计发布的图片和视频推文总数

default: 0

展开属性

Any of:

integer

integer

any

any

normal_followers_countinteger | any

普通未认证粉丝数量

default: 0

展开属性

Any of:

integer

integer

any

any

pinned_tweet_idsstring[]

用户个人主页置顶的推文 ID 列表

default: []

possibly_sensitiveboolean | any

该用户的个人主页是否可能涉及限制级/敏感内容

default: false

展开属性

Any of:

boolean

boolean

any

any

profile_banner_urlstring | any

用户个人主页横幅背景图片地址

展开属性

Any of:

string

string

any

any

profile_image_urlstring | any

用户个人主页高清头像图片的访问 URL

展开属性

Any of:

string

string

any

any

protectedboolean | any

该博主的推文是否处于私密锁推保护状态（仅获批粉丝可阅读）

default: false

展开属性

Any of:

boolean

boolean

any

any

statuses_countinteger | any

该账号历史累计发布的推文总数

default: 0

展开属性

Any of:

integer

integer

any

any

any

any

view_countstring | any

推文的实际总浏览/阅读次数（Impression）

展开属性

Any of:

string

string

any

any

view_count_statestring | any

浏览量统计状态（Enabled 表示已启用计数）

展开属性

Any of:

string

string

any

any

statusobject | any

来自推特底层的原始推文状态字典对象

展开属性

Any of:

object

object

any

any

target_countinteger | any

目标获取记录数量上限

展开属性

Any of:

integer

integer

any

any

any

any

has_next_pageboolean必填

是否存在下一页数据（true 表示还有更多数据）

next_cursorstring | any

用于拉取下一页数据的游标（Cursor）。当 has_next_page 为 true 时将此值作为下一页的 cursor 参数传入

展开属性

Any of:

string

string

any

any

422请求参数校验错误

detailValidationError[]

展开属性

Array of ValidationError

locstring | integer[]必填

展开属性

Array of string | integer

Any of:

string

string

integer

integer

msgstring必填

响应提示信息（例如 'success'）

typestring必填

inputany

ctxobject

⚡交互式测试 / Try APIPOST/twitter/advanced_search/page

Live Console

🌐目标服务器:https://api.twexapi.io

● 生产环境就绪

🔍

公开数据读取（仅需 TwexAPI 平台密钥，无需 Twitter Cookie）

本接口为公开推特数据检索/查询，无需任何推特账号或 Cookie！仅需在下方「API 鉴权」中输入您的 TwexAPI 平台密钥 (Bearer Token) 即可直接发起测试。

🔑API 鉴权

记住密钥同步到代码示例

TwexAPI 平台密钥 Bearer Token必填

用于调用 TwexAPI 平台全部接口的全局 API 密钥，在控制台获取。

📝请求体application/json

💡 快捷发送:⌘ / Ctrl+Enter

📡

暂无响应数据

请在「请求配置」中确认参数后，点击底部的「发送请求」按钮。

请求示例

curl -X POST "https://api.twexapi.io/twitter/advanced_search/page" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "searchTerms": [
    "python programming",
    "AI technology"
  ],
  "sortBy": "Latest",
  "next_cursor": ""
}'

const response = await fetch("https://api.twexapi.io/twitter/advanced_search/page", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "searchTerms": [
    "python programming",
    "AI technology"
  ],
  "sortBy": "Latest",
  "next_cursor": ""
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/twitter/advanced_search/page",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "searchTerms": [
    "python programming",
    "AI technology"
  ],
  "sortBy": "Latest",
  "next_cursor": ""
},
)

响应示例

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "tweet_id": "1803006263529541838",
      "is_paid_promotion": true,
      "text": "string",
      "created_at": "Mon Jun 17 03:51:48 +0000 2024",
      "created_at_datetime": "2024-06-17T03:51:48.000Z",
      "bookmark_count": 0,
      "bookmarked": false,
      "community_note": "string",
      "edit_tweet_ids": [],
      "editable_until_msecs": "string",
      "edits_remaining": "string",
      "favorite_count": 0,
      "favorited": false,
      "full_text": "string",
      "has_card": false,
      "has_community_notes": false,
      "hashtags": [
        "AI",
        "Python"
      ],
      "cashtags": [
        "$TSLA"
      ],
      "id": "string",
      "in_reply_to": "string",
      "in_reply_to_user_id": "string",
      "in_reply_to_screen_name": "string",
      "is_edit_eligible": false,
      "is_quote_status": false,
      "quoted_status_id_str": "string",
      "is_translatable": false,
      "lang": "en",
      "media": [],
      "place": "string",
      "poll": "string",
      "possibly_sensitive": true,
      "possibly_sensitive_editable": true,
      "quote": {},
      "quote_count": 0,
      "related_tweets": [],
      "replies": [],
      "reply_count": 0,
      "reply_to": {},
      "retweet_count": 0,
      "retweeted_tweet": {},
      "thread": [
        {}
      ],
      "thumbnail_title": "string",
      "thumbnail_url": "string",
      "urls": [],
      "user": {
        "id": "1717001045992251392",
        "name": "Cryptoklepto",
        "screen_name": "CK_Cryptoklepto",
        "created_at": "Mon Oct 28 02:32:47 +0000 2024",
        "created_at_datetime": "2024-10-28T02:32:47.000Z",
        "can_dm": false,
        "can_media_tag": false,
        "default_profile": false,
        "default_profile_image": false,
        "description": "",
        "description_urls": [],
        "urls": [
          {
            "url": "https://www.google.com",
            "expanded_url": "https://www.google.com",
            "display_url": "www.google.com"
          }
        ],
        "fast_followers_count": 0,
        "favourites_count": 0,
        "followers_count": 0,
        "following_count": 0,
        "has_custom_timelines": false,
        "is_blue_verified": false,
        "verified_type": "government",
        "is_verified": false,
        "profile_image_shape": "Circle",
        "is_translator": false,
        "listed_count": 0,
        "location": "New York, USA",
        "media_count": 0,
        "normal_followers_count": 0,
        "pinned_tweet_ids": [],
        "possibly_sensitive": false,
        "profile_banner_url": "string",
        "profile_image_url": "string",
        "protected": false,
        "statuses_count": 0
      },
      "view_count": "string",
      "view_count_state": "string",
      "status": {},
      "target_count": 0
    }
  ],
  "has_next_page": true,
  "next_cursor": ""
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}