X (Twitter) Trends Scraper

X (Twitter)

Operated by Sourcelane✓ verified

A location-aware scraper that extracts real-time trending topics and hashtags from X (Twitter), returning each trend's name, rank, the search query X uses to surface live conversations, a direct search URL for live results, and contextual meta information such as post volume or category. The connector targets trends at worldwide, country, or city granularity using location identifiers (Where On Earth ID), and is optimized for automated trend monitoring, keyword discovery, and programmatic ingestion of ranked topic data for downstream analysis.

Verified Sep 28, 12:10 AM

$0.002

per trend

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

What people use it for

Content calendar planning: identify trending topics and hashtags to schedule timely posts.
Real-time newsjacking: detect breaking topics and emerging conversations as they trend.
Marketing and PR trend monitoring: track brand- or industry-relevant trends and conversation volumes.
Social media management tooling: feed live trending topics into scheduling or content-generation pipelines.
Regional trend comparison: compare trending topics across different cities, countries, or global scope.

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-trends-scraper","params":{"woeid":1,"maxItems":5},"maxResults":10}'

Request params

Field	Type	Required	Description
`woeid`	integer	required	Yahoo 'Where On Earth ID' for the location whose trends you want. Common values: 1 = Worldwide, 23424977 = United States, 23424975 = United Kingdom, 44418 = London, 2459115 = New York, 455825 = Los Angeles, 1118370 = Tokyo. Look up other WOEIDs online if you need a different location.
`maxItems`	integer	optional	Maximum number of trending topics to return, ordered by rank. Set 0 for unlimited (all trends returned by the API). Capped at 100 per call.

Each result contains

Field	Type	Description
`woeid`	integer	Woeid
`rank`	integer	Rank
`name`	string	Name
`searchQuery`	string	Search Query
`metaDescription`	string	Meta Description
`tweetSearchUrl`	string	Tweet Search Url

Use X (Twitter) Trends 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-trends-scraper","params":{"woeid":1,"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-trends-scraper",
        "params": {"woeid":1,"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…