Fetch social data
fetch_social_dataRetrieve raw data from allowlisted social and web endpoints not covered by dedicated search tools. Use for long-tail queries across TikTok, Instagram, YouTube, Reddit, LinkedIn, and more.
Instructions
Generic escape hatch for any ALLOWLISTED long-tail social/web endpoint the dedicated search_* tools don't cover — e.g. {path:'/v1/instagram/profile', params:{handle:'nike'}}. Allowlisted platform families: TikTok (+ TikTok Shop), Instagram, YouTube, Facebook (organic profiles/posts/events/marketplace), LinkedIn (organic posts/companies), Twitter/X, Reddit, Threads, Snapchat, Pinterest, Twitch, Bluesky, Truth Social, Rumble, Spotify, SoundCloud, GitHub, Google search, link-in-bio pages (Linktree etc.). Param names vary per endpoint (profiles use handle, keyword searches use query, Reddit uses subreddit). WARNING: returns RAW provider JSON — large and messy; prefer the dedicated search_* tools. Spends credits.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "fetch_social_data"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | exact endpoint path, e.g. '/v1/tiktok/profile' — non-allowlisted paths are rejected | |
| params | No | endpoint query params, e.g. {handle:'nike'} | |
| get_cost | No | true: return the price only; nothing runs or bills | |
| idempotency_key | No | chosen once, resent unchanged on retries: the same key never buys twice | |
| expected_credits | No | the get_cost price; refused unbilled if the live price differs |