Utility Find Endpoint API
Scrape Utility Find Endpoint data with one API call. Describe what you want in plain words, in any language ("last 200 comments on this TikTok <url>", "German Instagram creators about matcha") and get the three endpoints most likely to do it, best first: each with its method and path, the parameters your words already filled (only values you typed, never made up), the ones still missing, the credits that one call would hold (null with a note when it cannot be quoted yet), a confidence and a one-line reason, plus a few alternatives. Act on the top result only when uncertain is false. When no endpoint matches what the task means, or the matcher is unavailable, the results are keyword guesses and uncertain is always true. A request to act on an account (post, reply, like, follow, message, delete), about your own account or customers, or about billing returns no results (reason not_a_data_job) and the nearest reads as alternatives. Pass platform to keep the answer on one platform. Nothing is run. Free to call.
Last updated October 2026Maintained by the SocialCrawl team
Returns the three endpoints most likely to do a task you describe, best first: the parameters your words filled, the ones still missing, one call's credits and a confidence.
Use it as the first step when you know the job but not the endpoint. It runs nothing, and says uncertain when you should check before calling. Free to call.
Searching 68 platforms in parallel
What can you do with the Find Endpoint API?
The Find Endpoint 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/find?task=last+200+comments+on+https%3A%2F%2Fwww.tiktok.com%2F%40stoolpresidente%2Fvideo%2F7623818255903329566"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/utility/find",
params={
'task': 'last 200 comments on https://www.tiktok.com/@stoolpresidente/video/7623818255903329566',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/utility/find?task=last+200+comments+on+https%3A%2F%2Fwww.tiktok.com%2F%40stoolpresidente%2Fvideo%2F7623818255903329566",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| task | No | The job in plain words, in any language. Up to 600 characters are read. Provide this or query |
| query | No | Alias for task. Provide this or task |
| platform | No | Keep the answer on one platform slug (tiktok, instagram, ...). Omit to search every platform |
What does the Utility Find Endpoint 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/find",
"data": {
"kind": "endpoint_find",
"version": 1,
"methodology_version": "find-1/router-3/lexical-1",
"platform": null,
"uncertain": false,
"reason": "routed",
"source": "router",
"confidence": 0.92,
"results": [
{
"id": "tiktok/post/comments",
"method": "GET",
"path": "/v1/tiktok/post/comments",
"params_filled": {
"url": "https://www.tiktok.com/@stoolpresidente/video/7623818255903329566"
},
"missing": [],
"estimated_credits": 1,
"expected_min": 1,
"pricing": "flat",
"confidence": 0.92,
"why": "Use it to read what people said under one TikTok video, a page at a time.",
"source": "router"
}
],
"alternatives": [
{
"id": "prism/comments",
"method": "GET",
"confidence": 0.04,
"source": "router"
}
],
"notes": [
"results are ranked best first. Act on results[0] only when uncertain is false; otherwise show the options or check them with GET /v1/utility/endpoint?id=."
]
},
"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 Find Endpoint 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 68 platforms covering 10B+ monthly active users.
One schema, every platform
Query 68 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 Find Endpoint data?
Get your API key and start pulling Utility data in under 60 seconds.
