Skip to main content

​
Tweet Scraper

Scrape tweets by URL, search terms, or Twitter handles with advanced filters for date, engagement, and verification. 1 credit/row

​
Parameters

ParameterTypeRequiredDescription
startUrlsarrayNoArray of tweet or profile URLs to scrape
searchTermsarrayNoArray of search queries. E.g., ["AI startup funding"]
twitterHandlesarrayNoArray of Twitter handles without @. E.g., ["elonmusk", "OpenAI"]
maxItemsintegerYesMaximum number of tweets to return. Default: 100
sortstringNoSort order. Default: Latest
onlyVerifiedUsersbooleanNoOnly return tweets from verified users
minimumRetweetsintegerNoMinimum retweet count filter
minimumRepliesintegerNoMinimum reply count filter
startstringNoStart date filter. Format: YYYY-MM-DD
endstringNoEnd date filter. Format: YYYY-MM-DD

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/twitter/tweet-scraper/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "searchTerms": ["AI startup funding"],
      "maxItems": 100,
      "sort": "Latest",
      "start": "2025-01-01",
      "end": "2025-03-31"
    }
  }'