Errors

All errors return JSON with code, message, and request_id.

HTTPcodemeaning
400invalid_requestBody missing url, gtin, or query.
401missing_keyNo Authorization header.
403key_revokedKey has been revoked or account suspended.
402payment_requiredx402 flow. See MCP docs.
404not_resolvableReference could not be resolved with sufficient confidence.
422low_confidenceResolved below 0.7; not cached.
429rate_limitedPer-key burst or sustained rate exceeded.
451takedownURL is under a takedown.
500internal_errorSomething on our side. Includes request_id.