{ "openapi": "3.0.1", "info": { "title": "Ofsted Inspections Scraper (England Schools & Childcare)", "description": "Search and monitor England's public Ofsted inspection register. Get normalized provider records (URN, provider, type, overall grade, inspection date, report URL) by keyword, postcode, local authority or URN, and only new or changed providers in monitor mode.", "version": "0.1", "x-build-id": "EbGfQ6hSYTMKZ6ypY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steadfetch~ofsted-inspection-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steadfetch-ofsted-inspection-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/steadfetch~ofsted-inspection-monitor/runs": { "post": { "operationId": "runs-sync-steadfetch-ofsted-inspection-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/steadfetch~ofsted-inspection-monitor/run-sync": { "post": { "operationId": "run-sync-steadfetch-ofsted-inspection-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urns": { "title": "Provider URNs", "type": "array", "description": "Optional. Fetch specific providers by their Ofsted URN (for example 140696). Each URN is looked up in the public search; exact matches only.", "items": { "type": "string" } }, "query": { "title": "Name, URN or keyword", "type": "string", "description": "Optional. Free-text search across provider name, URN or keyword, exactly as on reports.ofsted.gov.uk." }, "postcode": { "title": "Location or postcode", "type": "string", "description": "Optional. Search around a UK postcode or place name (for example SW1A 1AA)." }, "localAuthority": { "title": "Local authority code", "type": "string", "description": "Optional. Numeric Ofsted local-authority code (for example 202 for Camden). The code is shown in the site's Local Authority filter." }, "providerTypes": { "title": "Provider types to include", "type": "array", "description": "Optional. Narrow results to specific Ofsted provider categories (case-insensitive match against the Category field, for example Primary, Independent School, Childcare on Non-Domestic Premises). Leave empty for all types.", "items": { "type": "string" } }, "monitorMode": { "title": "Monitor mode", "type": "boolean", "description": "When enabled, only providers that are new or whose grade, inspection date, category or address changed since the previous run for the same Apify user are delivered, and each checked provider bills one monitor-check event. Leave disabled for a one-off backfill.", "default": false }, "knownState": { "title": "Known state (seed)", "type": "object", "description": "Optional. Monitor-mode seed of previously seen providers. Leave empty to keep using the state saved for your Apify user from the previous run." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of providers delivered to the dataset. Each delivered provider is one billable result event.", "default": 100 }, "strictSchema": { "title": "Strict output schema", "type": "boolean", "description": "Fail the run when an item does not match the OUTPUT schema. Keep enabled: Steadfetch never publishes Actors without output-schema validation.", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }