X (Twitter) Tweet Scraper

X (Twitter)

Operated by Sourcelane✓ verified

A scraper that searches X (Twitter) by keyword, hashtag, username, date range, language, media presence, or engagement thresholds using Twitter advanced-search syntax and returns structured per-tweet records. It can sort results by recency or by engagement, execute boolean and combined queries, and apply filters such as language, date ranges, and media-only tweets. The connector extracts tweet identifiers, full text and URLs, creation timestamps, language, engagement metrics (likes, retweets, replies, quotes, views, bookmarks), author metadata (username, display name, follower counts, verification status), and context identifiers for replies/quotes/retweets. It uses cursor-based pagination to traverse large result sets and can resume long extractions across runs; no login or developer account is required.

Verified Sep 28, 12:10 AM

$0.001

per tweet

Up to 100 per call. Only pay for results returned; failed calls are refunded.

What people use it for

Brand and competitor monitoring on X
Sentiment analysis and audience research
Lead generation by finding people tweeting about a niche
Trend tracking for hashtags, cashtags, or events
Influencer discovery by surfacing accounts driving engagement on a topic

Trust & reliability

7d uptime trend

Window	Uptime	Success rate	p50	p95
24h	—	—	—	—
7d	—	—	—	—
30d	—	—	—	—

Calling contract

Call it through Sourcelane's gateway or MCP server. We run the connector, apply your agent's spend guardrails, and bill only the results returned.

Call it via Sourcelane

curl -X POST https://cool-puffin-608.convex.site/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"x-tweet-scraper","params":{"query":"from:elonmusk min_faves:1000","maxItems":5},"maxResults":10}'

Request params

Field	Type	Required	Description
`query`	string	required	Twitter advanced search query. Supports operators like from:username, to:username, "exact phrase", #hashtag, $cashtag, lang:en, has:media, min_faves:100, min_retweets:50, since_time:UNIX, until_time:UNIX, OR, AND, parentheses.
`queryType`	string	optional	Latest returns most recent first. Top returns highest-engagement first.
`maxItems`	integer	optional	Maximum tweets to return. Set 0 for unlimited (use cautiously - large queries can be slow). Capped at 100 per call.
`pageId`	string	optional	Optional. Pass cursor_next from a previous run's output to resume from where the last run stopped.

Each result contains

Field	Type	Description
`tweetId`	string	Tweet Id
`url`	string	Url
`text`	string	Text
`createdAt`	string	Created At
`lang`	string	Lang
`source`	string	Source
`retweetCount`	integer	Retweet Count
`replyCount`	integer	Reply Count
`likeCount`	integer	Like Count
`quoteCount`	integer	Quote Count
`viewCount`	integer	View Count
`bookmarkCount`	integer	Bookmark Count
`isReply`	boolean	—
`inReplyToId`	null	—
`inReplyToUsername`	null	—
`conversationId`	string	—
`isQuote`	boolean	—
`isRetweet`	boolean	—
`quotedTweetId`	null	—
`retweetedTweetId`	null	—
`author`	object	—
`entities`	object	—

Use X (Twitter) Tweet Scraper from Claude, ChatGPT or Cursor

Pick your tool and connect in under a minute. Then just ask — for example: “Find the 50 most-liked tweets about 'MCP servers' this month and summarise the takes.”

Connect Claude

Web, desktop and mobile. Paste one URL.

1Copy your personal connector URL
2In Claude open Settings → Connectors → Add custom connector
3Paste the URL and click Add — done

Manual setup (config files, REST, Python) +

Claude Code

Adds the Sourcelane MCP server with your key as a header.

terminal

claude mcp add --transport http sourcelane https://cool-puffin-608.convex.site/mcp \
  --header "Authorization: Bearer sl_live_your_agent_key"

Claude Desktop (config file)

Alternative to the connector URL: add to claude_desktop_config.json, then restart Claude.

claude_desktop_config.json

{
  "mcpServers": {
    "sourcelane": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cool-puffin-608.convex.site/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

Cursor & Windsurf

Add to ~/.cursor/mcp.json (or Windsurf's mcp_config.json).

mcp.json

{
  "mcpServers": {
    "sourcelane": {
      "url": "https://cool-puffin-608.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

VS Code

Save as .vscode/mcp.json. VS Code prompts for your key once.

.vscode/mcp.json

{
  "servers": {
    "sourcelane": {
      "type": "http",
      "url": "https://cool-puffin-608.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sourcelane-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "sourcelane-key",
      "description": "Sourcelane agent key",
      "password": true
    }
  ]
}

ChatGPT Custom GPT (Actions)

Create a GPT → Actions → Import from URL, then Authentication: API Key, Bearer.

OpenAPI schema URL

https://sourcelane-amber.vercel.app/openapi.json

REST

One POST. Pass maxResults to cap cost.

curl

curl -X POST https://cool-puffin-608.convex.site/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"x-tweet-scraper","params":{"query":"from:elonmusk min_faves:1000","maxItems":5},"maxResults":10}'

Python, LangChain, CrewAI, OpenAI Agents SDK…

Wrap the REST call as a tool, or point an MCP client at the endpoint.

python

import requests

res = requests.post(
    "https://cool-puffin-608.convex.site/v1/call",
    headers={"Authorization": "Bearer sl_live_your_agent_key"},
    json={
        "listing": "x-tweet-scraper",
        "params": {"query":"from:elonmusk min_faves:1000","maxItems":5},
        "maxResults": 10,
    },
    timeout=300,
)
body = res.json()
print(body["receipt"]["chargedMicros"], "micro-USD for", body["receipt"]["results"], "results")
print(body["data"])

Reviews

—

0 reviews

Leave a review

Loading reviews…