Status Codes & Errors

The AI Parser returns standard HTTP status codes for every request. The table below lists each code, what it means and what to do next.

Code	Meaning	What to do
200 OK	Success	N/A
202 Accepted	Request accepted, processing asynchronously	Poll GET /parsers/<PARSER_ID> until status FINISED
204 No Content	Success, no response body (returned when deleting a parser)	N/A
400 Bad Request	Malformed JSON or missing required field	Check the request body. Ensure api_key, name and urls are present on POST /parsers
401 Unauthorized	Invalid api_key	Chek your API Key in the dashboard
402 Payment Required	Credits exhausted	Upgrade your plan or contact support
404 Not Found	parser_id doesn't exist	Verify the id with GET /parsers
500 Internal Server Error	Extraction failed	Retry the request. Try adding additional parameters. If extraction keeps failing, contact support

---

Separate from the HTTP statis codes, here are the possible values for the status field returned by GET /parsers/<PARSER_ID>

Status	Meaning
GENERATING	The parser is being generated. Parsing won't work yet
FINISHED	Parser is ready to use
FAILED	Generation failed. Check error field for details

Here are some common causes for status: "FAILED"

• Example URLs were inaccessible or blocked

• Example URLs were from a different URL Type (category, product, search, etc.)

• The domain may require JS Rendering and render=true was not set inside scraper_params