{"uid":"cap_41-cUHLy6FkYnibW9G6Vg","slug":"x402-twitter-pinned-tweet-api-1f77bcf1","name":"X402 Twitter Pinned Tweet API","description":"ReadX is a read-only X/Twitter JSON API. Profiles, timelines, tweets, search & lists — pay per call with x402 micropayments in USDC on Base or Solana. No API keys.","url":"https://x.1x402.sh/api/%7Bname%7D/pinned?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"code":0,"data":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ePlGHUQaGr_H2bDa_2P5t","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the pinned tweet for a given X/Twitter username via x402 micropayment-gated JSON API","exampleAgentPrompt":"What is the pinned tweet on @elonmusk's X profile? Use the x402 API to look it up and return the tweet content as JSON.","exampleUseCases":[{"title":"Monitor competitor pinned announcements","prompt":"Check what @CompetitorCorp has pinned on their X profile right now. Use the x402 API to fetch their pinned tweet and tell me what they're currently highlighting."},{"title":"Verify influencer brand positioning","prompt":"I need to see @TechInfluencer's pinned tweet to understand their current brand message. Pull it via the x402 API and summarize what they're emphasizing to their audience."},{"title":"Track CEO messaging updates","prompt":"Our CEO @OurFounder just mentioned they updated their X pinned tweet. Fetch it using the x402 API so I can see what message we're leading with and compare it to last week's version."}],"resultDescription":"A JSON object containing the pinned tweet data for the specified X/Twitter username, including tweet content and associated metadata, returned after a $0.05 USDC micropayment via x402 on Base.","failureModes":["Invalid or nonexistent username returns error code with empty data object","User has no pinned tweet returns empty data field","Payment failure or insufficient USDC balance blocks access with HTTP 402","Rate limiting or upstream X/Twitter API issues cause service unavailability","Malformed name parameter returns schema validation error"],"whenToPreferThis":"Use this endpoint when you need to programmatically retrieve a specific X/Twitter user's pinned tweet without obtaining official Twitter API credentials or going through their signup process. Ideal for agents that need quick, pay-per-use access to Twitter data via x402 micropayments on Base (USDC).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T15:28:21.209Z","isFirstParty":false,"canonicalSlug":"x402-twitter-pinned-tweet-api-1f77bcf1"}