Skip to content

Analyze document figures

Extract numbers from a spreadsheet or PDF, then recompute and compare them.

Markdown
POST/api/v1/analyze/documenthttps://api.webcite.co

When to use it

Use this when your starting point is a file. Use Compare figures when you already have structured figures. The public OpenAPI does not yet define a complete response schema.

Request

3 credits.

Examples run on your server. Set WEBCITE_API_KEY first. Python examples use the requests package.

curl
curl --fail-with-body -X POST 'https://api.webcite.co/api/v1/analyze/document' \
  -H "x-api-key: $WEBCITE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "asset_id": "YOUR_ASSET_ID"
}'

Request body

asset_idstringrequired

Uploaded asset id (from POST /upload). The spreadsheet is downloaded, figures are extracted deterministically with cell provenance, then recomputed and cross-checked.

Response

Returns extracted figures alongside conflicts, recomputations, and review information. Inspect extraction coverage as well as numeric findings.

200 response

See the response guidance above. A complete JSON schema is not published for this response.

Errors

For 400, check the request fields and source identifiers. For 401, check your API key. For 429, wait for the retry interval. See the errors guide before retrying a billable request.

400
Asset not found or unsupported type
401
Unauthorized - API key required
429
Rate limit exceeded
Error handling and retry guidance