搜索付费合作推文

按 screen_name 扫描近期推文，仅返回该作者明确标记 is_paid_promotion=true 的非转推内容。最多扫描 max_pages 页，每页最多请求 20 条，受可用额度限制。这是有限页扫描，不保证覆盖全部历史合作，也不会推断未披露的赞助。data 为空时仍可能 has_next_page=true，请传 next_cursor 继续。缺少披露标记的推文不计入结果，其数量在 disclosure_unknown_count 中返回。无需 X Cookie。

返回 API 接口列表

/Search Endpoints

TwexAPI REST

POST/twitter/search/paid_partnerships

API 鉴权

AuthorizationBearer token · header必填

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

请求体

必填application/json

screen_namestring必填

Username with or without @; profile URLs are not accepted.

matches ^\s*@?[A-Za-z0-9_]{1,15}\s*$

max_pagesinteger | any

Maximum search pages to scan, not the number of matching tweets. Omitted or null uses 1.

default: 1

展开属性

Any of:

integer

integer

any

any

next_cursorstring | any

展开属性

Any of:

string

string

any

any

响应结果

200Success

codeinteger必填

msgstring必填

dataTweetModel[]必填

展开属性

Array 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

has_next_pageboolean必填

next_cursorstring | any必填

展开属性

Any of:

string

string

any

any

pages_scannedinteger必填

min 0

tweets_scannedinteger必填

Number of tweets scanned, before filtering for paid promotion.

min 0

disclosure_unknown_countinteger必填

Unique eligible author tweets whose paid-promotion flag is missing; these are excluded from data.

min 0

stop_reasonstring必填

允许值:quota_limitcursor_exhaustedcursor_cyclepage_limit

400Invalid request

codeinteger必填

msgstring必填

dataany[] | any必填

展开属性

Any of:

any[]

Array of any

any

any

any

403Authentication or credit access denied

codeinteger必填

msgstring必填

dataany[] | any必填

展开属性

Any of:

any[]

Array of any

any

any

any

500Upstream or server error

codeinteger必填

msgstring必填

dataany[] | any必填

展开属性

Any of:

any[]

Array of any

any

any

any

⚡交互式测试 / Try APIPOST/twitter/search/paid_partnerships

Live Console

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

● 生产环境就绪

🔍

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

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

🔑API 鉴权

记住密钥同步到代码示例

TwexAPI 平台密钥 Bearer Token必填

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

📝请求体application/json

screen_namestring

必填Username with or without @; profile URLs are not accepted.

max_pagesstring

可选Maximum search pages to scan, not the number of matching tweets. Omitted or null uses 1.

next_cursorstring

可选

💡 快捷发送:⌘ / Ctrl+Enter

📡

暂无响应数据

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

请求示例

curl -X POST "https://api.twexapi.io/twitter/search/paid_partnerships" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "screen_name": "example_user",
  "max_pages": 1,
  "next_cursor": null
}'

const response = await fetch("https://api.twexapi.io/twitter/search/paid_partnerships", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "screen_name": "example_user",
  "max_pages": 1,
  "next_cursor": null
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/twitter/search/paid_partnerships",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "screen_name": "example_user",
  "max_pages": 1,
  "next_cursor": None
},
)

响应示例

{
  "code": 200,
  "msg": "success",
  "data": [],
  "has_next_page": false,
  "next_cursor": null,
  "pages_scanned": 1,
  "tweets_scanned": 20,
  "disclosure_unknown_count": 0,
  "stop_reason": "cursor_exhausted"
}

{
  "code": 400,
  "msg": "Invalid request",
  "data": []
}

{
  "code": 403,
  "msg": "Authentication or credit access denied",
  "data": []
}

{
  "code": 500,
  "msg": "Upstream or server error",
  "data": []
}