Ask in natural language
Ask a natural-language question and get a routed public API lookup.
One-shot routing only — not a chat. Prefer typed MCP/REST endpoints when you know the operation; use nl_ask_post / POST /v1/ask for exploratory natural-language lookups. For LLM Q&A about a single URL, use GET /v1/web/ask instead.
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
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`.