Error Codes

HTTP Status Codes

All Anysite API endpoints return standard HTTP status codes. Below is the complete list of error codes you may encounter.

Code	Description	Action
400	Invalid input format (e.g., malformed LinkedIn URN, missing required field)	Check your request body and parameter formats
401	Missing or invalid `access-token` header	Verify your API key at app.anysite.io
403	No access to the requested resource or account	Check your subscription plan and permissions
404	Requested entity not found (account, email, job listing, etc.)	Verify the URL, username, or ID you’re querying
408	Request execution timeout exceeded	Increase the `timeout` parameter or simplify your query
412	Entity unavailable at source (deleted, blocked, or URL not responding)	The target profile/page may have been removed or restricted
422	Validation error — request body doesn’t match expected schema	Check required fields and parameter types
429	Rate limit exceeded	Wait and retry, or reduce request frequency
500	Internal server error or data source unavailable	Retry after a short delay; contact support if persistent

All error responses return a JSON body:

{
  "detail": "Error description message"
}

For validation errors (422), the response includes field-level details:

{
  "detail": [
    {
      "loc": ["body", "user"],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}

// Invalid LinkedIn URN format
{"detail": "Invalid URN format. Expected: 'urn:li:fsd_profile:ABC123'"}

// User profile doesn't exist
{"detail": "LinkedIn user not found"}

Increase the timeout parameter in your request body (default: 300 seconds, max: 1500):

{
  "user": "linkedin.com/in/username",
  "timeout": 600
}

The target entity exists but is not accessible:

Check your current usage with the token management endpoints:

curl -H "access-token: YOUR_API_KEY" https://api.anysite.io/token/statistic