跳转到主要内容v2 Post 计数端点可帮助开发者了解并获取针对特定查询的数据量。这在多种情况下都有用,包括:
- 了解某个关键词的 Post 数量,以便构建可视化,例如趋势线。
- 确定事件或讨论发生的时间范围,确保你的查询覆盖相关数据。
- 评估搜索查询将返回多少条 Post,以便在使用“最近搜索”或“全量归档搜索”端点之前优化查询。
请注意: 计数结果不一定与搜索端点返回的结果完全一致,因为搜索端点会经过计数端点不涉及的额外合规处理。
- 了解某个话题相关讨论的规模,而无需实际拉取原始数据,也无需将这些 Post 计入你的每月Post 上限。
在构建查询时,你的查询长度和可用操作符将取决于你的访问级别。
- 如果你使用的是具有 Pro 访问权限的 Project,你可以使用所有可用操作符,且查询长度可达 1024 个字符。
- 如果你使用的是具有 Enterprise 访问权限的 Project,你可以使用所有可用操作符,且查询长度可达 4096 个字符。
你还可以指定粒度(可为 day、hour 或 minute)以及需要统计 Post 计数的时间范围(使用 start_time 和 end_time 参数)。该端点的默认时间粒度为 hour,这意味着如果你未指定 granularity 参数,端点将返回过去 7 天内按小时统计的 Post 计数。
账户设置要访问这些端点,你需要:在我们的入门指南中了解如何获取对 X API v2 端点的访问权限。
“最近的 Post 计数”端点允许你以编程方式检索过去七天内某个查询的 Post 数量。任何使用与某个App所在Project相关联的密钥和令牌的人都可以使用此端点,并通过OAuth 2.0 App-Only进行认证。
全量归档 Post 计数端点允许你以编程方式从所有公开 Post 的完整归档中检索某个查询的 Post 数量。目前,此端点仅向已获批的学术研究或企业版访问或学术研究或企业版访问用户开放,并需使用OAuth 2.0 仅应用模式进行认证。
例如:你可以使用全量归档 Post 计数端点查看 2017 年 8 月至 9 月间话题标签 #SOSHurricaneHarvey 每天的 Post 数量。
请注意:该计数端点的分页为每个响应覆盖 31 天。例如,设置为按天粒度时,将返回每页 31 天内每天的计数;设置为按小时粒度时,将返回每页 744 小时(31 天 × 24 小时)内每小时的计数。若未指定粒度和时间范围,此端点将返回最近 30 天内每小时的查询 Post 计数。