X
Posts of a user (timeline)
X (Twitter) posts of a user (timeline). When both are provided, `start_time` must be earlier than `end_time`. The user id comes from x/users-by-usernames. Price: $0.005 per post returned or hydrated, $0.01 per user hydrated (expansions). 5 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/user-postsListed
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/user-posts (X (Twitter) posts of a user (timeline)). Call inspect_tool with {"tool_id": "x/user-posts"} 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/user-posts" 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 |
|---|---|---|---|
id | string | Yes | Unique identifier of a User |
max_results | integer | No | |
pagination_token | string | No | A base32hex-encoded pagination token. |
start_time | string | No | Must be on or after 2010-11-06. |
end_time | string | No | Must be on or after 2010-11-06. |
since_id | string | No | |
until_id | string | No | |
exclude | string[] | No | |
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/user-posts",
"input": {
"id": "783214",
"max_results": 5
}
}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.