Home / Servers / X (Twitter) API / get_posts_counts_recent

Get Count of Recent Posts

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

Get Count of Recent Posts Retrieves the count of Posts from the last 7 days matching a search query. At most one of pagination_token, next_token may be provided. [GET /2/tweets/counts/recent]

Name on the gateway: x_api__get_posts_counts_recent · read-only.

Parameters

NameTypeDescription
query requiredstringquery parameter
start_timestringMust be within the last 7 days.
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_recent",
  "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 recent posts tool with query set to ….

More from X (Twitter) API