{ "openapi": "3.0.1", "info": { "title": "UK Parliament Scraper", "description": "Scrape UK Parliament open data - search MPs and Lords, get member profiles and careers, browse public bills, and pull House of Commons voting divisions. Powered by the official parliament.uk APIs. No login or API key.", "version": "1.0", "x-build-id": "w5aRjVmYrjfTribGg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~uk-parliament-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-uk-parliament-scraper", "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/crawlerbros~uk-parliament-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-uk-parliament-scraper", "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/crawlerbros~uk-parliament-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-uk-parliament-scraper", "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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "searchMembers", "memberDetails", "bills", "divisions" ], "type": "string", "description": "What to fetch.", "default": "searchMembers" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Text query. In `searchMembers` it matches member names; in `bills` it matches bill titles; in `divisions` it matches division titles. Leave blank in `bills`/`divisions` to browse the most recent items.", "default": "Starmer" }, "house": { "title": "House (searchMembers)", "enum": [ "", "Commons", "Lords" ], "type": "string", "description": "Restrict member search to a single House.", "default": "" }, "party": { "title": "Party (searchMembers)", "enum": [ "", "Labour", "Conservative", "Liberal Democrat", "Scottish National Party", "Reform UK", "Green Party", "Democratic Unionist Party", "Sinn Féin", "Plaid Cymru", "Social Democratic & Labour Party", "Ulster Unionist Party", "Alliance", "Traditional Unionist Voice", "Independent", "Crossbench", "Non-affiliated", "Bishops", "Conservative Independent", "Your Party", "Restore Britain" ], "type": "string", "description": "Restrict member search to a single party.", "default": "" }, "gender": { "title": "Gender (searchMembers)", "enum": [ "", "M", "F" ], "type": "string", "description": "Restrict member search to a single gender.", "default": "" }, "currentOnly": { "title": "Current members only (searchMembers)", "type": "boolean", "description": "Only include members who currently sit in Parliament. Turn off to include former members.", "default": true }, "memberIds": { "title": "Member IDs (memberDetails)", "type": "array", "description": "Parliament member IDs to fetch full profiles + careers for (e.g. `4514` for Keir Starmer). Accepts numeric IDs or members.parliament.uk profile URLs.", "default": [], "items": { "type": "string" } }, "billHouse": { "title": "Current House (bills)", "enum": [ "", "Commons", "Lords" ], "type": "string", "description": "Restrict bills to those currently before a single House.", "default": "" }, "billOriginatingHouse": { "title": "Originating House (bills)", "enum": [ "", "Commons", "Lords" ], "type": "string", "description": "Restrict bills to those first introduced in a single House.", "default": "" }, "includeVoters": { "title": "Include individual votes (divisions)", "type": "boolean", "description": "For divisions, also fetch the full list of MPs who voted Aye and No (adds one request per division).", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on the number of records emitted.", "default": 50 } } }, "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 } } }, "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 } } } } } } } } } }