What you get
- Trending topics and hashtags
- Rank and location
- Direct search link per trend
- Viral tweets by topic
Just ask your AI
“What's trending on X in the UK right now, and which trends are about tech?”
“Find the most viral tweets about AI agents this week.”
Connectors behind it
Your AI picks the right one for the question. Each is priced per result and refunded if it fails.
woeidranknamesearchQuerymetaDescriptiontweetSearchUrlX (Twitter) Viral Tweets Finder$0.004 per viral tweetFind viral tweets on any topic - set minimum likes and retweets, get engagement rates and virality scores for every result. No login required.topictweetIdurltextcreatedAtlangUse the Twitter trends API from Claude, ChatGPT or Cursor
Pick your tool and connect in under a minute. Then just ask — for example: “What's trending on X in the UK right now, and which trends are about tech?”
Connect Claude
Web, desktop and mobile. One click, then confirm.
- 1Click Add to Claude — claude.ai opens with Sourcelane filled in
- 2Click Continue to confirm — it then works in Claude desktop and mobile too
Manual setup (config files, REST, Python) +
Claude Code
Adds the Sourcelane MCP server with your key as a header.
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.
{
"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).
{
"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.
{
"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.
https://usesourcelane.com/openapi.jsonREST
One POST. Pass maxResults to cap cost.
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-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.
import requests
res = requests.post(
"https://api.usesourcelane.com/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"])Twitter trends API — FAQ
How do I pick a location?+
Pass a WOEID (Where On Earth ID) — 1 for worldwide, 23424977 for the US, 23424975 for the UK, or a city ID.
Do I need a X (Twitter) API key or developer account?+
No. Sourcelane runs the connectors for you. You top up a balance with a card, create an agent key, and your agent calls the connector — there is no X (Twitter) app review, OAuth setup or rate-limit juggling on your side.
Which AI tools can use it?+
Anything that speaks MCP (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf) can connect to the Sourcelane MCP server with one config block. ChatGPT can use it through a Custom GPT Action, and any agent framework can call the REST endpoint directly.
Can I stop an agent from overspending?+
Yes. Every agent key has its own per-call cap, daily and monthly limits, an optional lifetime budget, an allowlist of connectors, and a kill switch.
