{"uid":"cap_IZ8rUtGbgKLgFB6vkuYQo","slug":"api-paytoll-io-2aa1fa9c","name":"PayToll Twitter User Profile Lookup","description":"Payment required: $0.02","url":"https://api.paytoll.io/v1/twitter/user?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"userId":{"type":"string","pattern":"^[0-9]+$","description":"Twitter user ID. Provide username OR userId, not both."},"username":{"type":"string","pattern":"^[A-Za-z0-9_]{1,15}$","description":"Twitter username (without @). Provide username OR userId, not both."},"userFields":{"type":"array","items":{"enum":["id","name","username","description","public_metrics","profile_image_url","verified","created_at","location","url"],"type":"string"},"description":"User fields to return. Defaults to: id, name, username, description, public_metrics, profile_image_url"}}},"responseSchema":null,"example":{"request":{"username":"twitter"},"response":{"user":{"id":"1683696495198089217","name":"Twitter","username":"twitter","withheld":{"country_codes":["JP"]},"description":"This account is no longer active. Follow @x for updates.","public_metrics":{"like_count":0,"media_count":0,"tweet_count":0,"listed_count":0,"followers_count":0,"following_count":0},"profile_image_url":"https://pbs.twimg.com/profile_images/1683698521600565248/_R1r5HsQ_normal.jpg"}}},"exampleRequest":{"username":"twitter"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"0.55","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_r2vc5Ka47S50FkyMTZTEX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a Twitter/X user's public profile and metadata (followers, bio, metrics) by username or user ID as a paid API call.","exampleAgentPrompt":"Can you look up the Twitter profile for the username 'elonmusk' and tell me their follower count, bio, and profile image?","exampleUseCases":null,"resultDescription":"Returns a user object containing the Twitter user's ID, display name, username, bio description, profile image URL, withheld country codes, and public metrics including follower count, following count, tweet count, like count, media count, and listed count.","failureModes":["User not found: invalid or suspended username/ID returns an error","Invalid input: providing both username and userId simultaneously","Invalid username format: username doesn't match pattern ^[A-Za-z0-9_]{1,15}$","Invalid userId format: userId doesn't match numeric pattern ^[0-9]+$","Payment failure: insufficient USDC balance or x402 payment rejected","Rate limiting: too many requests in a short period","Account withheld in certain countries: partial data returned with withheld country codes"],"whenToPreferThis":"Use this endpoint when you need structured Twitter/X public profile metadata (follower counts, bio, profile image) for a known username or user ID, especially in agent workflows where micropayment-based access (USDC on Base) is acceptable and no OAuth token is available. Prefer over scraping or full Twitter API integration when cost per call is acceptable at $0.02 and only public data is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":11,"lastUsedAt":"2026-04-15T20:54:50.567Z","lastSuccessfullyRanAt":"2026-04-15T20:54:50.567Z","lastHealthCheckAt":"2026-10-12T06:26:19.492Z","isFirstParty":false,"canonicalSlug":"api-paytoll-io-2aa1fa9c"}