# Errors

Errors


      # Stable error codes


      Extraction failures include `errorCode` and `errorMessage`. Agents should branch on the code, not the human string.


      
        CodeMeaningWhat to do
        
          INVALID_URLURL missing, malformed, or not a postAsk the user for a full public post URL
          PLATFORM_NOT_SUPPORTEDHost not in the catalogCheck /docs/platforms or /features
          PRIVATE_OR_UNAVAILABLEPrivate, geo-blocked, or deletedDo not retry blindly; tell the user
          RATE_LIMITProvider or app rate limitWait; honor Retry-After if present
          EXTRACTION_FAILEDProvider cascade exhaustedRetry once; then report partial results
          API_ERRORInternal or upstream API errorRetry with backoff
        
      
      HTTP 401: missing/invalid JWT. HTTP 402-equivalent: insufficient credits (message in body). HTTP 429: rate limited.