跳转到主要内容
v2 Post 计数 endpoint 使开发者能够了解并获取给定 query（查询）的数据量。这在多种情况下都很有用，包括：
  • 了解某个关键词的 Post 数量，以构建可视化（如趋势线）。
  • 确定事件或讨论发生的时间区间，确保你的 query 捕获到相关数据。
  • 在使用 recent search 或 full-archive search endpoint 之前，估算搜索 query 将返回的 Post 数量，从而优化你的 query。 请注意： 计数结果不一定总是与搜索 endpoint 的结果一致，因为搜索 endpoint 会经过额外的合规处理，而计数 endpoint 不会。
  • 在无需实际拉取原始数据、也无需将 Post 计入你的每月Post 上限的情况下，了解某一话题相关讨论的规模。 
在编写 query 时，你会受到 query 长度和可用操作符的限制，具体取决于你的访问级别。 
  • 如果你使用的是具有 Pro 访问权限的 Project，你可以使用所有可用的操作符，且 query 最长可达 1024 个字符。 
  • 如果你使用的是具有 Enterprise 访问权限的 Project，你可以使用所有可用的操作符，且 query 最长可达 4096 个字符。 
你还可以指定时间粒度（day、hour 或 minute）以及需要获取 Post 计数的时间范围（使用 start_time 和 end_time 参数）。此 endpoint 的默认时间粒度为 hour，这意味着如果你未指定 granularity 参数，endpoint 将返回过去 7 天中按小时聚合的 Post 计数。
账户设置要访问这些 endpoint，你需要：在我们的入门指南中了解有关获取 X API v2 endpoint 访问权限的更多信息。

​
近期 Post 计数

“近期 Post 计数” endpoint 允许你以编程方式在过去七天内根据一个 query（查询）检索 Post 的数量计数。凡是使用与某个 App（属于某个 Project）关联的密钥和令牌的用户均可访问此 endpoint，并通过 OAuth 2.0 App-Only 进行身份验证。

​
全量归档 Post 计数

full-archive Post counts endpoint 允许你以编程方式从所有公共 Posts 的完整归档中检索某个 query（查询）的 Post 数量。目前，此 endpoint 仅向已获批准的Academic Research 或 Enterprise 访问用户开放，并需使用 OAuth 2.0 App-Only 进行身份验证。 例如：你可以使用 full-archive Post counts endpoint 查看 2017 年 8 月至 9 月期间，每天包含话题标签 #SOSHurricaneHarvey 的 Posts 数量。 请注意：counts endpoint 的分页以 31 天为一个响应页面。比如，将粒度设置为 day 时，会返回每页 31 天内“按天”的结果计数；将粒度设置为 hour 时，会返回每页 744 小时（31 天 × 24 小时）内“按小时”的结果计数。若未指定粒度和时间范围，此 endpoint 将在过去 30 天内按小时返回某个 query 的 Post 计数。
⌘I