Authentication
All requests require a bearer token:
Authorization: Bearer tc_live_•••
Get your key from the dashboard. Free tier = 100 calls/month.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| url | string | ✓ | Full URL including https:// |
Response
All responses are JSON with snake_case keys. On success, the tool-specific data is returned. On error, the body has at minimum an error field with a human-readable message.
Rate-limit headers are always included:
X-RateLimit-Limit— monthly quotaX-RateLimit-Remaining— calls left this monthX-RateLimit-Reset— Unix timestamp of next resetX-Plan— current plan nameX-Request-Id— for support tickets
Errors
| Status | When |
|---|---|
| 400 | Missing or invalid parameter (validation failed). |
| 401 | API key missing or invalid. |
| 403 | IP not whitelisted, or URL points to a private / metadata address. |
| 429 | Monthly quota exhausted — see X-RateLimit-Reset. |
| 503 | Upstream service (worker / search) temporarily unavailable. |