Skip to main content

​
比较 X API 的搜索 Post 端点

v2 Search Tweets 端点最终将取代 标准版 v1.1 search/posts 端点和 企业版 Search API。如果你有使用旧版 X 搜索端点的代码、应用或工具，并计划迁移到更新的 X API v2 端点，那么本指南适合你。 本页包含三个对比表：

​
近期搜索对比

下表对比了各类近期搜索端点：
描述Standard v1.1X API v2
主机域名https://api.x.comhttps://api.x.com
端点路径/1.1/search/tweets.json/2/tweets/search/recent
认证OAuth 1.0a 用户上下文
OAuth 2.0 仅应用		OAuth 1.0a 用户上下文

OAuth 2.0 授权码（PKCE）

OAuth 2.0 仅应用
时间戳格式YYYYMMDDYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
返回的 Post 不早于7 天7 天
支持的 HTTP 方法GETGET
默认请求速率限制使用 OAuth 1.0a 用户上下文每 15 分钟 180 次请求

使用 OAuth 2.0 仅应用每 15 分钟 450 次请求		基础：

使用 OAuth 2.0 仅应用每 15 分钟 60 次请求

使用 OAuth 1.0a 用户上下文每 15 分钟 60 次请求

使用 OAuth 2.0 授权码（PKCE）每 15 分钟 60 次请求

Pro：

使用 OAuth 2.0 仅应用每 15 分钟 450 次请求

使用 OAuth 1.0a 用户上下文每 15 分钟 180 次请求

使用 OAuth 2.0 授权码（PKCE）每 15 分钟 180 次请求
提供完全展开的 URL✔
每个响应的最大 Post 数量（默认）100（15）100（10）
Post JSON 格式Standard v1.1 格式X API v2 格式（由 fields 和 expansions 请求参数决定，与 v1.1 格式不向后兼容）

要了解如何从 Standard v1.1 格式迁移到 X API v2 格式，请参阅我们的数据格式迁移指南。
支持选择在载荷中返回哪些fields✔
支持请求并接收annotations✔
支持在 Post 对象内请求特定的metrics✔
支持 conversation_id 运算符和字段✔
提供 Post 编辑历史✔✔
Post 数据数组的 JSON 键名statusesdata
分页的 JSON 键名search_metadata.next_resultsmeta.next_token
支持按时间范围浏览归档✔✔
基于时间的请求的时间分辨率daysecond
时区UTCUTC
按时间浏览的请求参数untilstart_time
end_time
按 Post ID 浏览的请求参数since_id 
max_id		since_id 
until_id
分页的请求参数提供 URL 编码的查询next_token
需要使用与Project关联的开发者应用凭证✔

​
全量归档搜索对比

下表比较了不同类型的全量归档搜索端点：
说明企业版X API v2
主机域名https://gnip-api.x.comhttps://api.x.com
端点路径/search/fullarchive/accounts/:account_name/:label/2/tweets/search/all
认证Basic authOAuth 2.0 仅应用
时间戳格式YYYYMMDDHHMMYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
可返回的 Posts 最早时间自 2006 年 3 月起的完整归档自 2006 年 3 月起的完整归档
支持的 HTTP 方法GET
POST		GET
默认请求速率限制每分钟的速率限制将根据您的合同中约定的合作伙伴而有所不同。

使用 Basic auth 时每秒 20 次请求		使用 OAuth 2.0 仅应用时每 15 分钟 300 次请求

使用 OAuth 2.0 仅应用时每秒 1 次请求
提供完全展开的 URL✔✔
每个响应中的 Posts 数量最大值：500
默认值：100		最大值：500
默认值：10
Post JSON 格式Native Enriched 或 Activity Streams 格式X API v2 格式（由 fields 和 expansions 请求参数决定）
支持选择在负载中返回哪些 fields✔
支持请求和接收 annotations✔
支持在 Post 对象内请求特定的 metrics✔
支持 conversation_id 运算符和字段✔
提供 Post 编辑历史✔✔
Post 数据数组的 JSON 键名resultsdata
分页的 JSON 键名nextmeta.next_token
基于时间请求的时间分辨率秒秒
时区UTCUTC
支持按 Post ID 浏览归档✔
按时间导航的请求参数fromDate
toDate		start_time
end_time
按 Post ID 导航的请求参数since_id
until_id
分页的请求参数next_tokennext_token
需要使用与具有 Academic Research 访问权限的 Project 关联的 开发者应用 的凭证✔
过滤运算符对比 四个不同版本（standard、enterprise 和 v2）的搜索 Posts 在可用运算符上存在差异，并且各版本内部的运算符可用级别也不同，具体如下。 Enterprise
  • 不存在 enterprise 运算符的子层级
X API v2
  • 免费： 适用于任何 Project
  • 基础： 适用于任何 Project
  • Pro： 适用于某个 Project
  • 企业版： 适用于某个 Project
您可以在各自的指南中进一步了解上述每组运算符： 既然我们已经了解了 X API v2 中不同的运算符级别，下面的表格列出了搜索 Posts 的运算符可用性（注意：如果单元格留空，则表示该运算符不可用）：
搜索运算符Standard企业版v2
keyword可用
q:keyword		可用基础与免费
emoji可用
q:😄		可用基础与免费
“exact phrase”可用可用基础与免费
#可用可用基础与免费
$可用可用免费
@可用可用基础与免费
from:可用可用基础与免费
to:可用可用基础与免费
url:可用可用基础与免费
retweets_of:可用基础与免费
context:基础与免费
entity:基础与免费 - 仅适用于最近搜索
conversation_id:基础
place:可用免费
place_country:可用免费
point_radius:geocode 参数可用免费
bounding_box:可用免费
is:retweetfilter:retweets可用基础与免费
is:reply可用基础与免费
is:quote可用基础与免费
is:verified可用基础与免费
-is:nullcast可用免费
has:hashtags可用基础与免费
has:cashtags可用免费
has:linksfilter:links可用基础与免费
has:mentions可用基础与免费
has:mediafilter:media可用基础与免费
has:imagesfilter:images, filter:twimg可用基础与免费
has:videosfilter:videos
filter:native_video		可用基础与免费
has:geo可用免费
lang:lang - 可作为运算符或参数使用可用基础与免费
has:profile_geo可用
profile_country可用
profile_locality可用
profile_region可用
proximity可用
:(可用
:)可用
?可用
filter:periscope可用
list:可用免费
filter:replies可用
filter:pro_video可用
filter:social可用
filter:trusted可用
filter:follows可用
filter:has_engagement可用
include:antisocial可用
include:offensive_user可用
include:antisocial_offensive_user可用
include:sensitive_content可用
source:可用
min_replies:可用
min_retweets:可用
min_faves:可用
card_name:可用
card_domain:可用
其他迁移资源 X API 迁移中心 查看这些端点的示例代码 搜索 Posts：Standard v1.1 到 X API v2 搜索 Posts：Enterprise 到 X API v2