X · Posts from the last 7 days
Recent search
X (Twitter) recent search: posts from the last 7 days. At most one of `start_time`, `since_id` may be provided. Query operators: keywords, "exact phrase", #hashtag, @mention, from:, to:, lang:, has:images, has:links, -is:retweet, -is:reply, is:verified. Ask for tweet.fields=created_at,public_metrics and expansions=author_id with user.fields=username to get authors. Price: $0.005 per post returned or hydrated, $0.01 per user hydrated (expansions). 10 to 100 posts per page. Billed on the resources actually returned (posts and users), the quote is the upper bound; X's 24-hour deduplication is not passed through.
Usage based XSocialx/search-recentListed
Activation pending; your agent will see it as unavailable until then.
Use this tool with your agent
Use my connected Agentik MCP server. I want to use the tool x/search-recent (X (Twitter) recent search: posts from the last 7 days). Call inspect_tool with {"tool_id": "x/search-recent"} first and tell me the price before anything runs. Ask me for the inputs it needs; never invent values, IDs or file URLs. When I confirm, call run_tool with tool_id "x/search-recent" and my inputs, follow it with get_run if it is still running, and give me the result and the price Agentik reports. If the tool is unavailable, say so and use discover_tools to propose an alternative.Show the prompt
Paste it into Claude, ChatGPT or Codex: your agent takes it from there, and shows the price before it runs.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | Yes | |
max_results | integer | No | |
next_token | string | No | A base32hex-encoded pagination token. |
pagination_token | string | No | A base32hex-encoded pagination token. |
start_time | string | No | Must be within the last 7 days. |
end_time | string | No | |
since_id | string | No | |
until_id | string | No | |
sort_order | string | No | Options: recency, relevancy. |
post.fields | string[] | No | The fields available for a Post object. |
expansions | string[] | No | A comma separated list of fields to expand. |
user.fields | string[] | No | The fields available for a User object. |
media.fields | string[] | No | The fields available for a Media object. |
poll.fields | string[] | No | The fields available for a Poll object. |
place.fields | string[] | No | The fields available for a Place object. |
How your agent calls it
First inspect_tool for the current schema and price, then run_tool with the published example after confirming your inputs:
{
"tool_id": "x/search-recent",
"input": {
"query": "from:X -is:retweet",
"max_results": 10
}
}Price and billing
- Price
- Usage based
- Model
- Usage based
- Detail
- Billed at the cost the provider reports for the call, never above $3. Your agent sees the maximum before running.
- The provider’s price, 0% markup.
- One prepaid balance for every provider; your agent sees the price before it runs.
- Pay for measured usage; unused reservations are released.