X (Twitter) Viral Tweets Finder

X (Twitter)

Operated by Sourcelane✓ verified

Finds high-performing tweets for any topic by applying engagement thresholds and a time window to X/Twitter content, returning per-tweet metadata (identifiers, URL, full text, timestamp, language), raw engagement counts (likes, retweets, replies, quotes, views, bookmarks), computed virality metrics (total engagement as the sum of interactions; engagement rate as engagement divided by views; virality multiplier as views relative to the author’s follower count), and author metadata (username, display name, verification status, follower count, profile image). The connector pre-filters and ranks results by engagement, supports advanced query syntax (exact phrases, OR, hashtags, cashtags), handles pagination for multi-page retrievals, and operates without requiring login or cookies.

Verified Sep 28, 3:56 AM

$0.004

per viral tweet

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

What people use it for

Content research — reverse-engineer hooks and formats that trigger viral engagement in a niche
Trend detection — surface rising or breaking topics within a chosen time window
Influencer discovery — identify creators whose tweets outperform their follower base
Social listening — monitor high-impact conversations about a brand, product, or market
Newsletter & curation — compile top tweets on a topic for curated lists or summaries

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://api.usesourcelane.com/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"x-viral-tweets-scraper","params":{"topic":"artificial intelligence","maxItems":5},"maxResults":10}'

Request params

Field	Type	Required	Description
`topic`	string	required	Keyword, phrase, #hashtag, or $cashtag to find viral tweets about. Supports quotes for exact phrases and OR for alternatives.
`minLikes`	integer	optional	Only return tweets with at least this many likes. Set 0 to disable the likes filter.
`minRetweets`	integer	optional	Only return tweets with at least this many retweets. Set 0 to disable the retweets filter.
`daysBack`	integer	optional	Only return tweets posted within the last N days. Set 0 for all time.
`language`	string	optional	Optional ISO language code filter, e.g. en, es, ja. Leave empty for all languages.
`excludeReplies`	boolean	optional	Skip reply tweets and only return original posts.
`onlyWithMedia`	boolean	optional	Only return tweets containing an image or video.
`sortBy`	string	optional	Top returns the highest-engagement tweets first. Latest returns the most recent matching tweets first.
`maxItems`	integer	optional	Maximum tweets to return. Set 0 for unlimited (auto-paginates). Capped at 100 per call.
`pageId`	string	optional	Optional. Paste NEXT_PAGE_ID from a previous run's Key-value store to fetch the next page.

Each result contains

Field	Type	Description
`topic`	string	Topic
`tweetId`	string	Tweet Id
`url`	string	Url
`text`	string	Text
`createdAt`	string	Created At
`lang`	string	Lang
`likeCount`	integer	Like Count
`retweetCount`	integer	Retweet Count
`replyCount`	integer	Reply Count
`quoteCount`	integer	Quote Count
`viewCount`	integer	View Count
`bookmarkCount`	integer	Bookmark Count
`totalEngagement`	integer	—
`engagementRatePct`	number	—
`viralityMultiplier`	number	—
`hasMedia`	boolean	—
`mediaTypes`	array	—
`authorUsername`	string	—
`authorUserId`	string	—
`authorName`	string	—
`authorIsBlueVerified`	boolean	—
`authorFollowersCount`	integer	—
`authorProfilePicture`	string	—

Use X (Twitter) Viral Tweets Finder 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://api.usesourcelane.com/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://api.usesourcelane.com/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://api.usesourcelane.com/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://api.usesourcelane.com/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://usesourcelane.com/openapi.json

REST

One POST. Pass maxResults to cap cost.

curl

curl -X POST https://api.usesourcelane.com/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"x-viral-tweets-scraper","params":{"topic":"artificial intelligence","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://api.usesourcelane.com/v1/call",
    headers={"Authorization": "Bearer sl_live_your_agent_key"},
    json={
        "listing": "x-viral-tweets-scraper",
        "params": {"topic":"artificial intelligence","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…