# Social Fetch API - System endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

2 documented System operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## POST /v1/ask
Ask in natural language
Credit cost: Routing is free. The nested lookup bills at that endpoint's normal credit rate — see meta.creditsCharged.
Docs: https://www.socialfetch.dev/docs/api/v1/ask/post.mdx
SDK: client.ask({ query: "How many TikTok followers does MrBeast have?" })
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 POST

## GET /health
Health check
Auth: anonymous (no API key required)
Docs: https://www.socialfetch.dev/docs/api/health/get.mdx
SDK: client.health()
curl "https://api.socialfetch.dev/health"