agentutility(7)$ man user-tweets
/user-tweets
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobeCATEGORY
uncategorized
STATUS
● live
NAME
user-tweets — user tweets api / latest tweets from username / x user timeline / twitter user posts endpoint
SYNOPSIS
POST https://x402.agentutility.ai/user-tweets
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
User tweets API / latest tweets from username / X user timeline / Twitter user posts endpoint. Read-only X API v2 route: resolves a public username, fetches recent public posts from that user, excludes retweets by default, and returns text, timestamps, metrics, pagination token, and author profile. No posting, replying, liking, following, DM access, or account mutation.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| mode | string | Use 'user_tweets' for public timeline lookup. enum: user_tweets | optional |
| username | string | X/Twitter handle, with or without @. | required |
| max_results | number | Number of recent posts to fetch. Clamped to 5-50. Default 10. | optional |
| pagination_token | string | Optional X pagination token for the next page. | optional |
| include_retweets | boolean | Include retweets when true. Defaults false. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| mode | string | — |
| username | string | — |
| result_count | string | — |
| tweets | string | — |
| source | string | — |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/user-tweets \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the user-tweets tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- web-probeusertweetsuser-tweets
- methods
- POST
- cluster
- webprobe
- price
- $0.01 USDC per call
ADJACENT — other endpoints in webprobe
| endpoint | description | price |
|---|---|---|
| b2b-lead-enrich | B2B lead enrichment API / sales lead enrichment / prospect enrichment lite. | $0.01 |
| company-enrich | Company enrichment API / domain enrichment / organization enrichment / firmographic lite. | $0.01 |
| contact-enrich | Contact enrichment API / email-to-contact enrichment / lead contact lookup. | $0.01 |
| domain-enrich | Domain enrichment API / company enrichment / firmographic lite. | $0.01 |
| google-search | Google Search API / web SERP API / agent source discovery. | $0.01 |
| lead-enrich | Lead enrichment API / person enrichment / people enrich / email enrichment lite. | $0.01 |
| people-enrich | People enrichment API / person enrichment / email enrichment / lead enrichment lite / Apollo alternative for agents. | $0.01 |
| people-search | People search API / lead lookup / lightweight people enrichment. | $0.01 |
SEE ALSO