Errors and limits

Code	Meaning	What to do
`UNAUTHORIZED`	Authentication is missing or invalid.	Reconnect OAuth or replace the API key.
`INVALID_INPUT`	Tool arguments do not match the schema.	Correct the filters and retry.
`INVALID_CURSOR`	The cursor is malformed, expired, or used with different filters.	Restart the search or restore the original filters.
`REQUEST_TOO_LARGE`	The MCP request body is too large.	Remove unnecessary context or arguments.
`RATE_LIMITED`	The credential or service exceeded its short-term request limit.	Wait and retry with backoff.
`CONCURRENCY_LIMITED`	Too many searches are running at once.	Wait for an active request to finish.
`INSUFFICIENT_CREDITS`	No active credits remain.	Check Usage and contact Superdata support.
`REQUEST_IN_PROGRESS`	The same metered request is already pending or complete.	Wait for the first response; do not submit duplicates.
`PROVIDER_TIMEOUT`	The search exceeded its deadline.	Narrow the filters and retry.
`PROVIDER_UNAVAILABLE`	Superdata could not complete provider work.	Retry shortly; contact support if it persists.
`PROVIDER_BUDGET_EXHAUSTED`	A service-level safety budget has been reached.	Retry later.
`INTERNAL_ERROR`	An unexpected safe server error occurred.	Retry once, then contact support.

Limits

Result limit: 1–50 per page
Filter terms: up to 10 values per list
Filter text: up to 120 characters per term
Cursor: up to 512 characters
Requests are subject to credential rate, global rate, concurrency, body-size, provider-budget, and execution-deadline controls

Exact operational thresholds can change to protect service reliability.