{"uid":"cap_XlR8vI97FERHChF7nsbQe","slug":"agdata-twitter-data-api-f9c57a0c","name":"agdata Twitter Data API","description":"Unblock any URL as Markdown, or get search, social, maps, jobs and news as data. Paid per call in stablecoins over x402 or MPP, with no account.","url":"https://agdata.shveik.dev/v1/mpp/twitter?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["profile","search"],"type":"string"},"limit":{"type":"integer","maximum":20,"minimum":1},"query":{"type":"string","maxLength":500}}},"responseSchema":{"type":"json","example":{"id":"21046956…","url":"https://…","lang":"en","text":"On Monda…","author":{},"isReply":false,"createdAt":"Mon Sep…","isRetweet":false,"likeCount":1210,"viewCount":352841,"quoteCount":11,"replyCount":59,"retweetCount":141,"bookmarkCount":54}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.014","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.014/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pNF6FsZc1U5z4f_krlDNk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.014","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetch structured Twitter/X data by searching tweets or retrieving a user profile, paid per call via stablecoin microtransaction","exampleAgentPrompt":"Search Twitter for the 10 most recent tweets about 'AI agents' and give me the text, like counts, and view counts for each one.","exampleUseCases":[{"title":"Brand mention monitoring on X","prompt":"Search Twitter for up to 20 recent tweets mentioning 'OpenAI' and pull back the engagement stats — likes, retweets, and views — so I can see how the conversation is trending."},{"title":"Public figure tweet surveillance","prompt":"Pull the latest 15 tweets from Elon Musk's Twitter profile and show me what he's been posting along with the engagement numbers for each tweet."},{"title":"Competitor social listening","prompt":"Search Twitter for the last 10 tweets about 'Anthropic Claude' and give me the full text and engagement metrics so I can track what people are saying."}],"resultDescription":"A JSON object per tweet containing: tweet ID, URL, language code, full tweet text, author details object, boolean flags for reply and retweet status, ISO creation timestamp, and engagement counts including likes, views, retweets, quotes, replies, and bookmarks.","failureModes":["Query string exceeds 500 characters — request rejected","Limit value outside 1–20 range — validation error","Invalid mode value (not 'profile' or 'search') — schema rejection","Payment insufficient or stablecoin transaction fails — 402 response","Twitter/X rate limiting or blocking on backend — partial or empty result set","User handle does not exist in profile mode — empty or error response","Network timeout on agdata backend — HTTP 5xx"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable Twitter/X data (tweets, engagement metrics) without setting up a Twitter Developer account or managing OAuth tokens. It is especially useful for agents that need ad-hoc social data lookups, pay-per-use billing via stablecoins (USDC over x402/MPP), and support for both keyword search and profile-level tweet retrieval in a single endpoint with a consistent JSON schema.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:33:09.594Z","isFirstParty":false,"canonicalSlug":"agdata-twitter-data-api-f9c57a0c"}