{"uid":"cap_IBjW_tmhCoM25Jk4YBMSF","slug":"twitter-x-posts-scraper-by-profile-f252ce6a","name":"Twitter/X Posts Scraper by Profile","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/twitter-posts?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","default":"","description":"Optional case-insensitive text or hashtag match within posts from the supplied profiles. This is not site-wide search."},"usernames":{"type":"array","description":"Public account handles or profile URLs to inspect. Only the recent posts visible on these pages are searched."},"searchType":{"enum":["latest","top"],"type":"string","default":"latest","description":"Sort collected posts by publication time or by likes among the public slice."},"timeWindow":{"type":"integer","minimum":1,"description":"Optional age limit in days. Hours takes precedence when both are set."},"resultsCount":{"type":"integer","default":30,"minimum":1,"description":"Maximum number of matching posts in the result dataset across all profiles."},"timeWindowHours":{"type":"integer","minimum":1,"description":"Optional age limit in hours; overrides the day limit."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"media":null,"author":null,"postId":null,"postUrl":null,"postText":null,"timestamp":null,"replyCount":null,"conversationId":null}],"product":"twitter-posts"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pJDc5h6xVGMClMrVAVNAQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes and filters recent posts from specified Twitter/X public profiles, returning structured post data with optional text/hashtag filtering and time windowing.","exampleAgentPrompt":"Pull the latest 20 posts from @elonmusk and @naval on X from the past 3 days, filtering for any posts that mention 'AI' — sort by most recent.","exampleUseCases":[{"title":"Brand social media monitoring","prompt":"Grab the last 50 posts from @Nike and @Adidas on X from the past 7 days and flag any that mention 'sale' or 'discount' — sort by latest."},{"title":"Influencer content research","prompt":"Get the top 30 posts by likes from @naval and @paulg on Twitter over the past 14 days so I can see what topics are resonating with their audiences."},{"title":"Competitor hashtag tracking","prompt":"Scrape the most recent 25 tweets from @OpenAI and @AnthropicAI that contain the hashtag '#AGI' posted within the last 48 hours."}],"resultDescription":"A JSON object containing a count of matched posts and an array of post items, each with post ID, URL, full text, author handle, timestamp, reply count, conversation ID, and any attached media references.","failureModes":["Private or suspended accounts return no results — charge may be waived","Invalid or non-existent usernames produce empty item arrays","timeWindowHours and timeWindow both set — hours takes precedence, days value ignored","resultsCount exceeding available public posts returns fewer items than requested","Rate limits or anti-scraping measures on X may cause partial or failed runs — not charged on failure"],"whenToPreferThis":"Choose this endpoint when you need structured post data from specific known Twitter/X accounts rather than a site-wide keyword search. It is ideal for monitoring named profiles, extracting posts for sentiment analysis, or tracking what specific users or brands are posting. Prefer it over general social media APIs when you need pay-per-call pricing with no charge on empty results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:25.187Z","isFirstParty":false,"canonicalSlug":"twitter-x-posts-scraper-by-profile-f252ce6a"}