{"uid":"cap_NLBjSCJax-hGZm81nor82","slug":"socialfetch-list-tweets-from-x-profile-7630684a","name":"SocialFetch – List Tweets from X Profile","description":"List tweets from an X profile by handle.","url":"https://api.socialfetch.dev/v1/twitter/profiles/:handle/tweets","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["handle"],"properties":{"handle":{"type":"string","description":"X (Twitter) profile handle without the leading @, or a numeric user id."}}},"queryParams":{"type":"object","properties":{"by":{"enum":["id","handle"],"type":"string","description":"Treat the path value as a handle or a numeric user id. Defaults to id when the value is all digits."},"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Requested page size (1–100). Best-effort; the actual page size may differ."},"cursor":{"type":"string","minLength":1,"description":"Opaque pagination cursor returned by a previous response."},"includePinned":{"anyOf":[{"type":"boolean"},{"enum":["0","1","true","false"],"type":"string"}],"description":"When true, includes the pinned tweet when available."},"includeReplies":{"anyOf":[{"type":"boolean"},{"enum":["0","1","true","false"],"type":"string"}],"description":"When true, includes reply tweets. Defaults to false."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_lGR_k-etfPEWasXD3cLVZ","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":"Fetches a paginated list of tweets from a specified X (Twitter) profile by its handle.","exampleAgentPrompt":"Can you pull the last 50 tweets from the X profile @naval — skip replies but include any pinned tweets?","exampleUseCases":[{"title":"Brand monitoring on X","prompt":"Grab the 100 most recent tweets from @Nike on X — no replies — so I can analyze how they're messaging their latest campaign."},{"title":"Competitor research feed","prompt":"Pull the latest 40 tweets from @OpenAI's X account, including pinned tweets, so I can see what announcements they've made recently."},{"title":"Influencer content audit","prompt":"Fetch the last 60 tweets from the X handle @paulg, including replies this time, and paginate if you need to — I want the full picture of what he's been saying this month."}],"resultDescription":"Returns a paginated list of tweet objects from the specified X profile, each containing tweet content and metadata. A cursor is included in the response to fetch the next page. The first page can optionally include pinned tweets, and replies can be toggled on or off.","failureModes":["Handle not found or account does not exist — likely a 404 or empty result","Account is private or suspended — access denied or empty list","Invalid or expired pagination cursor — may return an error or restart pagination","Limit parameter out of range (below 1 or above 100) — validation error","Rate limiting by the upstream X API — service may return a 429 or timeout"],"whenToPreferThis":"Choose this endpoint when you need to retrieve a chronological list of tweets from a known public X profile by handle, with control over pagination, reply inclusion, and pinned tweet inclusion. Prefer it over search-based endpoints when the target account is known and you want timeline-style data rather than keyword-matched results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:49:48.873Z","isFirstParty":false}