Live tweet search and AI-written trend digests, built for AI agents. No Twitter/X API key. No subscription. No developer-account approval. Your agent pays a fraction of a cent per call in USDC on Base.
See a real digest — free, no wallet →
| Endpoint | Price | Returns |
|---|---|---|
| GET /x/digest | $0.05 | The one to use for trends. Tweets plus an AI digest: 3–5 sentence trend summary, sentiment with the reason behind it, key themes, the accounts driving it, and the notable posts. Skips the second LLM call you'd otherwise make to summarize raw results yourself. |
| GET /x/leads | $0.05 | The PEOPLE behind matching posts, enriched: bio, website, emails found in bios, follower count, location, DM-open flag, and every matching post per person. Cofounder search, B2B lead gen, influencer discovery, community sourcing. ?max=20|40. |
| GET /x/leads-deep | $0.20 | The whole search, profile, contact chain in ONE call: up to 4 pages of search, the top 10–15 people enriched from their own websites (emails, LinkedIn, GitHub), clustered, with a one-line why-they-match each. ?query=&max=1-15. Free masked sample. |
| GET /x/pain-points | $0.05 | Pass a product or brand, get clustered pain points, feature requests and praise mined from live X posts — verbatim quotes and URLs. Product research, competitor research, churn signals, roadmap input. ?product=. |
| GET /x/search | $0.02 | Raw tweets only — up to 20 newest matches with author, follower count, timestamp, permalink and engagement. The cheap on-ramp when you want to do your own analysis. |
| GET /x/user | $0.02 | Latest tweets from one account, plus its pinned tweet. ?username=. |
| GET /x/profile | $0.02 | Full public profile: bio, followers, verified, join date. ?username=. |
| GET /x/replies | $0.02 | The reply thread under a post. ?id=. |
| GET /x/users | $0.02 | Find X accounts by name, topic, or keyword. ?query=. |
| GET /x/tweet | $0.01 | One tweet by id, with live engagement. ?id=. |
| GET /x/account-verdict | $0.02 | Is this account real? Bot check + verdict (real person / organization / likely bot / parody / inactive / unclear), confidence, known-for, red flags, plus non-LLM stats (account age, posts/week, avg engagement, reply share). ?username=. |
| GET /x/watch | $0.05 | Only what's new since your last check — pass back the cursor you got last time. Cursor-based monitoring, no re-reading the same tweets. ?query=&since=. |
| GET /x/list | $0.05 | A watchlist of 2-50 handles' combined recent tweets in ONE call, newest first, deduped, per-handle counts, since-cursor for only-what's-new next time — no splitting into several from: OR-term searches. ?handles=a,b,c&since=&limit=. |
| GET /x/followers | $0.02 | One page of an account's followers. ?username=&cursor=. |
| GET /x/following | $0.02 | One page of who an account follows. ?username=&cursor=. |
| GET /x/mentions | $0.02 | Tweets mentioning a handle, one page. ?username=&cursor=. |
| GET /x/engagers | $0.05 | Who quoted and who retweeted a post. ?id=. |
Invalid input returns 400 before payment — you are never charged for a miss.
Three promises. (1) Nothing found = nothing charged — an empty answer comes back as 404 no_results and the payment is never settled. (2) Same call within 10 minutes = free — you get the saved answer, no charge. (3) Hit the 20-tweet cap? Follow next.older in the answer for the next 20 older matches — no date slicing.
Every paid answer ends with a next block — the exact URL for only-what's-new since that answer (/x/watch cursor) and the cheap version (same query with since:). Don't pay twice for the same tweets.
Full X advanced search: from:elonmusk starship · "exact phrase" · #bitcoin min_faves:100 · $NVDA · lang:en since:2026-08-01 · airdrop -giveaway
# Free sample — a real digest, no payment
curl https://clink-lithium-vault.fly.dev/x/example
# Paid — your agent handles the 402 automatically
curl "https://clink-lithium-vault.fly.dev/x/digest?query=%23bitcoin%20min_faves:100"The twitter-signal-mcp MCP server exposes both tiers as tools. Your agent pays from its own wallet.
npx -y twitter-signal-mcp| Bad query | Rejected before payment — no charge. |
| Tweet source fails after you paid | You get an explicit error and the call is logged for refund — never a silent empty result. |
| Repeat query within 60s | Served from cache. |
| Gas | Covered by the facilitator. You spend USDC only. |