Skip to main content

​
比较 X API 的 Post 计数端点

v2 Post 计数端点最终将取代企业版 Search API 的计数端点。如果你有使用较早版本 Post 计数端点的代码、应用或工具，并计划迁移到更新的 X API v2 端点，那么本指南适合你。 本页包含三张对比表：

​
近期 Post 计数比较

企业版的 Post 计数端点允许你获取过去 30 天或全量归档的计数。因此，查看 7 天时间范围的 v2 近期 Post 计数端点并不能直接替代上述任一端点。 不过，为便于对比，我们将看看 v2 近期 Post 计数端点与企业版 30 天端点的差异。 下表对比了各类近期 Post 计数端点：
说明企业版X API v2
主机域名https://gnip-api.x.comhttps://api.x.com
端点路径/search/30day/accounts/:account_name/:label/counts.json/2/tweets/counts/recent
认证基础认证OAuth 2.0 Bearer Token
时间戳格式YYYYMMDDhhmmYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
返回的 Post 最久不超过31 天7 天
支持的 HTTP 方法GETGET
默认请求速率限制每秒 20 次请求，搜索数据与计数请求合并计算
每分钟的速率限制将根据你的合同按合作方而定。		每 15 分钟每用户 180 次请求
每 15 分钟每应用 450 次请求
是否支持使用 annotations 进行过滤✔
是否支持使用 conversation_id 进行过滤✔
用于 Post 数据数组的 JSON 键名resultsdata
时间粒度天、小时或分钟天、小时或分钟
时区UTCUTC
选择时间范围的请求参数fromDate
toDate		start_time
end_time
按 Post ID 导航的请求参数since_id
until_id
是否需要使用与项目关联的开发者应用的凭据✔

​
全量归档 Post 计数比较

下表对比了不同类型的全量归档搜索端点：
描述企业版X API v2
主机域名https://gnip-api.x.comhttps://api.x.com
端点路径/search/fullarchive/accounts/:account_name/:label/counts/2/tweets/counts/all
认证基础认证OAuth 2.0 持有者令牌
时间戳格式YYYYMMDDHHMMYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
返回的 Post 计数不早于自 2006 年 3 月起的完整归档自 2006 年 3 月起的完整归档
支持的 HTTP 方法GET
POST		GET
默认请求速率限制每分钟的速率限制将根据您的合同中约定的合作方条款而有所不同。
每秒 20 次请求		每个应用每 15 分钟 300 次请求
每个应用每秒 1 次请求
粒度天、小时、分钟天、小时、分钟
支持使用注释进行过滤✔
支持使用conversation_id进行过滤✔
Post 数据数组的 JSON 键名resultsdata
选择时间段的请求参数fromDate
toDate		start_time
end_time
通过 Post ID 导航的请求参数since_id
until_id
分页的 JSON 键名nextmeta.next_token
分页的请求参数next_tokennext_token 或 pagination_token
时区UTCUTC
需要使用与具有学术研究访问权限的Project关联的开发者应用的凭据✔

​
过滤运算符对比

企业版与 v2 两个不同版本的 Post 计数在可用运算符上有所差异，而且每个版本内部的运算符可用层级也不同，详情如下。 Enterprise
  • 企业版运算符没有子层级。所有企业版运算符对所有企业版用户均可用。
X API v2
  • 核心（Core）：这些运算符对任何 v2 用户都可用。
  • 高级（Advanced）：这些运算符仅对已获批学术研究访问权限的用户开放。
您可以在各自的指南中进一步了解这些运算符集合： 既然我们已经了解了 X API v2 中不同的运算符层级，下面的表格列出了 Post 计数的运算符可用性（注意：如果单元格为空，表示该运算符不可用）：
Enterprisev2
keywordAvailableCore
emojiAvailableCore
“exact phrase”AvailableCore
#AvailableCore
$AvailableAdvanced
@AvailableCore
from:AvailableCore
to:AvailableCore
url:AvailableCore
retweets_of:AvailableCore
context:Core
entity:Core - Only available with recent search
conversation_id:Core
place:AvailableAdvanced
place_country:AvailableAdvanced
point_radius:AvailableAdvanced
bounding_box:AvailableAdvanced
is:retweetAvailableCore
is:replyAvailableCore
is:quoteAvailableCore
is:verifiedAvailableCore
-is:nullcastAvailableAdvanced
has:hashtagsAvailableCore
has:cashtagsAvailableAdvanced
has:linksAvailableCore
has:mentionsAvailableCore
has:mediaAvailableCore
has:imagesAvailableCore
has:videosAvailableCore
has:geoAvailableAdvanced
lang:AvailableCore
list:Advanced
has:profile_geoAvailable
profile_countryAvailable
profile_localityAvailable
profile_regionAvailable
proximityAvailable
其他迁移资源 X API 迁移中心 查看这些端点的示例代码 Post 计数：从 Enterprise 迁移到 X API v2