Utility Call Planner API
Scrape Utility Call Planner data with one API call. Turn a job written in plain words ("track mentions of Acme on TikTok and Reddit", "a creator's profile, posts and comments") into the exact calls to make, in order: method, path, the parameters your question filled, the ones still missing, which step's rows fill a later step, the credit price of each call, and a curl for each with every unknown value left as a {placeholder}. Four jobs are planned today (brand monitoring, one creator, a topic search, a saved search on a monitor); a one-call question returns that one call. A question outside those returns uncertain with no steps instead of a guessed chain, and anything the API cannot return (a follower history, a new-post webhook) is listed under cannot. Nothing is run. Free to call.
Last updated September 2026Maintained by the SocialCrawl team
Returns the calls for a job you describe in plain words, in order: each path, the parameters your words filled, the ones still missing, its price, and a curl with unknown values left as placeholders.
Use it before writing an integration, when you know the job but not the endpoints. It plans and never runs anything. Free to call.
Searching 67 platforms in parallel
TikTok·
Instagram·
YouTube·
Facebook·
X·
LinkedIn·
Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·
Apple Music·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·
Yelp·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·
Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·Utility·
Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchWhat can you do with the Call Planner API?
The Call Planner endpoint gives you structured Utility data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/utility/plan?query=Combine+%40acme%27s+TikTok+profile+with+their+recent+videos+and+the+comments+on+them"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/utility/plan",
params={
'query': 'Combine @acme\'s TikTok profile with their recent videos and the comments on them',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/utility/plan?query=Combine+%40acme%27s+TikTok+profile+with+their+recent+videos+and+the+comments+on+them",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| query | Yes | The job in plain words, in any language. Up to 600 characters are read |
What does the Utility Call Planner API return?
This synthetic fixture shows the documented response shape and fields. Values are illustrative; this is not a live API response.
Example response
{
"success": true,
"platform": "utility",
"endpoint": "/v1/utility/plan",
"data": {
"kind": "call_plan",
"version": 1,
"recipe": "creator_profile",
"uncertain": false,
"reason": "planned",
"confidence": 0.91,
"steps": [
{
"id": "tiktok_profile",
"method": "GET",
"path": "/v1/tiktok/profile",
"params": {
"handle": "acme"
},
"missing": [],
"credits": 1,
"run": "ready",
"curl": "curl -H \"x-api-key: YOUR_API_KEY\" \\\n \"https://www.socialcrawl.dev/v1/tiktok/profile?handle=acme\""
},
{
"id": "tiktok_posts",
"method": "GET",
"path": "/v1/tiktok/profile/videos",
"params": {
"handle": "acme"
},
"missing": [],
"depends_on": "tiktok_profile",
"credits": 1,
"run": "after_approval",
"curl": "curl -H \"x-api-key: YOUR_API_KEY\" \\\n \"https://www.socialcrawl.dev/v1/tiktok/profile/videos?handle=acme\""
},
{
"id": "tiktok_comments",
"method": "GET",
"path": "/v1/tiktok/post/comments",
"params": {},
"missing": [
"url"
],
"binds": {
"url": "tiktok_posts.items[].url"
},
"depends_on": "tiktok_posts",
"credits": 1,
"run": "blocked",
"curl": "curl -H \"x-api-key: YOUR_API_KEY\" \\\n \"https://www.socialcrawl.dev/v1/tiktok/post/comments?url={url}\""
}
],
"ask": [],
"cannot": [],
"cannot_ids": [],
"alternatives": [],
"cheaper": "single_endpoint",
"deeper": null
},
"credits_used": 0,
"request_id": "req_example000000",
"cached": false
}Synthetic fixture for the documented response shape. Values are illustrative, not a production capture.
How does the Utility Call Planner API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 67 platforms covering 10B+ monthly active users.
One schema, every platform
Query 67 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Ready to scrape Utility Call Planner data?
Get your API key and start pulling Utility data in under 60 seconds.