RankParse

Error Codes

Complete reference of error codes returned by the RankParse API.

Error response format

All errors return a JSON object with three fields:

{
  "error": "error_type",
  "code": "error_code",
  "message": "Human-readable description"
}

Error codes

HTTP StatusCodeDescription
400bad_requestMissing or invalid query parameters
401unauthorizedMissing or invalid API key
402payment_requiredInsufficient credits for this request
404not_foundEndpoint does not exist
429rate_limitedRate limit exceeded (60 req/min)
500internal_errorServer error (retry later)

Notes

  • A domain with no data returns 200 with data: [], not 404
  • The page-meta endpoint returns 200 with data: null when a URL is not found
  • Stub endpoints (link-velocity, new-links, lost-links) return 200 with status: "not_yet_available"
  • Failed requests do not deduct credits

On this page