Home / Servers / X (Twitter) API / get_posts_counts_all

Get Count of All Posts

An MCP tool from the X (Twitter) API server, hosted on mcp.hjlabs.in.

Get Count of All Posts Retrieves the count of Posts matching a search query from the full archive. At most one of pagination_token, next_token may be provided. [GET /2/tweets/counts/all]

Name on the gateway: x_api__get_posts_counts_all · read-only.

Parameters

NameTypeDescription
query requiredstringquery parameter
start_timestringstart_time parameter
end_timestringend_time parameter
since_idstringsince_id parameter
until_idstringuntil_id parameter
next_tokenstringA base32hex-encoded pagination token.
pagination_tokenstringA base32hex-encoded pagination token.
granularityminute | hour | daygranularity parameter
search_count.fieldsstringsearch_count.fields parameter

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "x_api__get_posts_counts_all",
  "arguments": {
    "query": "…"
  }
}

Or connect the X (Twitter) API server directly, which lists 258 tools including this one:

Run in your terminal
claude mcp add --transport http hj-x-api https://mcp.hjlabs.in/mcp/x-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the get count of all posts tool with query set to ….

More from X (Twitter) API