{"uid":"cap_ghRnHsvENMXJeIj3VC3H9","slug":"twitter-x-user-media-timeline-ff42b037","name":"Twitter/X User Media Timeline","description":"Get a paginated timeline of media posts from an X user.","url":"https://twitter.use.x402atlas.com/user-media","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"},"queryParams":{"type":"object","required":["username"],"properties":{"username":{"type":"string","pattern":"^@?[A-Za-z0-9_]{1,15}$","maxLength":16,"description":"X username, with or without a leading @"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","data","result_count"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"cursor":{"type":"string","description":"Opaque cursor for the next page, when supplied by X"},"queried_at":{"type":"string","format":"date-time"},"result_count":{"type":"integer","minimum":0}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"user":{"name":"Bill Gates","id_str":"50393960","screen_name":"BillGates"},"id_str":"1903602810652082591","full_text":"Example X post","created_at":"Sun Mar 23 12:00:00 +0000 2025","reply_count":8,"retweet_count":15,"favorite_count":120}],"cursor":"NEXT_PAGE_CURSOR","queried_at":"2026-07-26T12:00:00Z","result_count":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_95UsI9H5sne1aPswRj3Fy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a paginated timeline of media posts (photos, videos, GIFs) from a specified public X (Twitter) user account.","exampleAgentPrompt":"Can you pull all the media posts from @NatGeo on X — photos, videos, everything — and give me the first page of results?","exampleUseCases":[{"title":"Brand visual content audit","prompt":"Fetch the media timeline for @Nike on X so I can see all the photos and videos they've been posting recently."},{"title":"Influencer content research","prompt":"Can you pull the media posts from @MrBeast on X? I want to see what kind of visual content he's been sharing lately."},{"title":"Journalist photo archive lookup","prompt":"Get me the media timeline for @AP on Twitter — I need to browse the photos and videos they've published on their X account."}],"resultDescription":"Returns a paginated array of media post objects from the specified X user, including post data fields (text, media attachments, engagement metrics, timestamps), a total result count, the datetime the query was made, and an opaque cursor string for fetching the next page when more results are available.","failureModes":["Invalid or non-existent username returns empty results or error","Private/protected accounts return no media","Rate limiting from X API results in failed or empty responses","Username pattern mismatch (exceeds 15 chars or invalid chars) rejected at input validation","No media posts on account returns empty data array with result_count 0","Pagination cursor expires or becomes invalid between requests"],"whenToPreferThis":"Use this endpoint when you specifically need the media-only timeline (photos, videos, GIFs) of a public X user, rather than their full text post history. Prefer this over the general user timeline endpoint when visual content is the focus. It is well-suited for content audits, influencer research, brand monitoring, or any workflow that needs to aggregate or analyze the visual media output of a specific X account.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T06:31:42.275Z","isFirstParty":false}