Skip to main content

​
401 Unauthorized

Check that:
  • x-api-key is present
  • the API key is valid for the environment you are calling
  • proxies are not stripping custom headers

​
400 Bad Request

Check that:
  • required fields are present
  • URLs are valid URIs
  • numeric fields such as limit or scoring weights are inside allowed ranges
  • extraction schemas are valid JSON objects

​
Run never reaches completed

Check that:
  • you are polling GET /api/v1/runs/{runId}
  • the run is not stuck in failed or cancelled
  • you are inspecting last_error and related fields
  • your client timeout is not shorter than the job duration you expect

​
Results are missing content

Not every result will have every output format. Confirm that:
  • you requested the relevant formats
  • the source page could actually produce that content format
  • the result does not contain an error_message

​
Search results look weak

Check that:
  • the underlying content is already indexed
  • the query is specific enough
  • ranking controls are still using sensible defaults
  • you are scoping by collection where appropriate