Ask in natural language
Route a natural-language social-data question to the right lookup when you do not yet know the typed tool — prefer typed tools once the operation is known.
Headers
Get your API keyAPI key (`sfk_...`)
Request body
Endpoint-specific response payload.
Echo of the submitted natural-language question.
Resolved public API operation for the natural-language request.
Resolved public API operation id, e.g. youtube.channel.get.
HTTP method for the routed lookup.
OpenAPI path template for the routed lookup.
Path and query parameters for the routed lookup.
Nested lookup response from the routed public API operation.
Success payload from the routed lookup. Shape depends on the resolved operation.
Request id for the nested lookup response.
Credits charged for the routed lookup.
one of: v1
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/ask" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"How many TikTok followers does MrBeast have?"}' \
-X POSTResponses
Routed lookup result with the underlying public API response nested in `data.lookup`.