Response Codes

Every response—whether successful or failed—includes an X-Request-Id header. Providing this ID to us helps us troubleshoot and pinpoint issues more quickly.

The HTTP response status code is always 200;

The response body always contains the fields code, message, and data;

Success Status Code #

The success status code is consistently code: 0, indicating that the server has successfully processed the request, with an HTTP response status of 200.

For example, a standard response body looks like this:

{
"code": 0,
"message": "success",
"data": {
"http_status": 200,
"outputs": {
"html": "html content..."
}
}
}

Overview of Parsing Result Error Codes #

Stage	Possible Error Codes
Temporary Service Exception	100001
Request Parameter Validation	100301
API Key Authentication	110102, 110103, 110104
Plan Retrieval	110205
Balance/Quota Check	110301
Crawler Execution Pipeline	120001 – 120008

API Key Authentication Errors #

Error Code	Trigger Scenario
110102	API Key is missing, malformed, invalid, or has been updated.
110103	API Key is currently disabled.

110104API Key status is abnormal; please retrieve a new one and try again.

Plan Errors #

Error Code	Trigger Scenario
110205	The current plan status is abnormal and cannot be used for this request.

Balance Errors #

Error Code	Trigger Scenario
110301	Insufficient available credit or balance before initiating the request.

Request Processing Errors #

Error Code	Trigger Scenario
120401	The request failed validation before processing (e.g., request frequency too high, connection interrupted, or request content non-compliant).
120402	The service is currently busy and cannot accept the request.
120403	Request processing failed; unable to retrieve the target page content.
120404	Request processing took too long and exceeded the allowed time limit.
120405	The service is currently unavailable; please try again later.
120406	A parameter value in the current request is not supported.

120408The current request lacks necessary conditions, so this capability cannot be used.
Example: When requesting the png format, the JS rendering capability must also be explicitly enabled.