spicrawl-com · Schema
UsageReconciliation
CompanyWeb ScrapingData ExtractionAutomationArtificial Intelligence
Properties
| Name | Type | Description |
|---|---|---|
| day | string | UTC day reconciled. |
| drift | array | Disagreements. Empty means no drift. |
| request_log_rows | integer | Rows the Postgres request log holds for the day. 0 means there was nothing to reconcile against. |
| interpretation | string | What the drift can and cannot prove. Read this before acting on `drift`. |
| repairable | boolean | Always false; the API never repairs billing data. Contact support to dispute. |
| warnings | array | Extra caveats. Omitted when empty. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/spicrawl-com/json-schema/spicrawl-com-usage-reconciliation-schema.json",
"title": "UsageReconciliation",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/spicrawl-com-usage-api-openapi.yml#/components/schemas/UsageReconciliation",
"type": "object",
"required": [
"day",
"drift",
"request_log_rows",
"interpretation",
"repairable"
],
"properties": {
"day": {
"type": "string",
"format": "date",
"description": "UTC day reconciled."
},
"drift": {
"type": "array",
"items": {
"$ref": "#/$defs/UsageDriftItem"
},
"description": "Disagreements. Empty means no drift."
},
"request_log_rows": {
"type": "integer",
"format": "int64",
"minimum": 0,
"description": "Rows the Postgres request log holds for the day. 0 means there was nothing to reconcile against."
},
"interpretation": {
"type": "string",
"description": "What the drift can and cannot prove. Read this before acting on `drift`."
},
"repairable": {
"type": "boolean",
"const": false,
"description": "Always false; the API never repairs billing data. Contact support to dispute."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
},
"description": "Extra caveats. Omitted when empty."
}
},
"$defs": {
"UsageDriftItem": {
"type": "object",
"required": [
"project_id",
"metric",
"stored_qty",
"observed_qty",
"delta",
"action"
],
"properties": {
"project_id": {
"type": "string",
"description": "Project the drift is in."
},
"metric": {
"$ref": "#/$defs/UsageMetric"
},
"stored_qty": {
"type": "integer",
"format": "int64",
"description": "Billed quantity (usage_daily)."
},
"observed_qty": {
"type": "integer",
"format": "int64",
"description": "Quantity re-derived from the Postgres request log."
},
"delta": {
"type": "integer",
"format": "int64",
"description": "Difference reported by the reconciliation function. Do not treat as a refund or charge without reading `interpretation`."
},
"action": {
"type": "string",
"enum": [
"missing_in_usage_daily",
"absent_from_request_log",
"undercounted",
"overcounted"
],
"description": "The reconciliation verdict. `absent_from_request_log` usually means the log expired, not overbilling."
}
}
},
"UsageMetric": {
"type": "string",
"enum": [
"requests",
"credits",
"engine_ms",
"bytes_egress",
"bytes_ingress",
"proxy_bytes_dc",
"proxy_bytes_resi",
"extractions",
"ai_extractions",
"batch_items",
"requests_failed",
"requests_timeout",
"feature_actions",
"feature_ai_extract",
"feature_autoparse",
"feature_extract",
"feature_extract_preset",
"feature_js_render",
"feature_links",
"feature_network_capture",
"feature_pdf",
"feature_proxy_country",
"feature_proxy_custom",
"feature_screenshot",
"feature_session",
"client_cli",
"client_mcp",
"client_sdk",
"client_other"
],
"description": "Usage metric name. `requests_failed`/`requests_timeout` count failed and timed-out requests, `feature_*` count requests that used a feature, `client_*` count requests by client surface (CLI, MCP, SDK, other). Billing metric name. `credits` is in micro-credits and is total credit spend, batch items included; `engine_ms` in milliseconds; byte metrics in bytes; the rest are counts. New metrics may appear as map keys in responses."
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/spicrawl-com-usage-reconciliation"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.