{ "openapi": "3.0.1", "info": { "title": "UK MP Financial Interests Watchlist", "description": "Track named UK MPs via the official Parliament Register of Interests API and get only NEW shareholdings, gifts, donations, land, jobs and foreign trips registered since your last run.", "version": "0.1", "x-build-id": "M2sdsaLMtfFTqYemP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hllerdgn80~uk-mp-financial-interests-watchlist/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hllerdgn80-uk-mp-financial-interests-watchlist", "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/hllerdgn80~uk-mp-financial-interests-watchlist/runs": { "post": { "operationId": "runs-sync-hllerdgn80-uk-mp-financial-interests-watchlist", "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/hllerdgn80~uk-mp-financial-interests-watchlist/run-sync": { "post": { "operationId": "run-sync-hllerdgn80-uk-mp-financial-interests-watchlist", "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": { "mpNames": { "title": "MP names", "type": "array", "description": "Full names of the MPs to watch, e.g. \"Rishi Sunak\" or \"Keir Starmer\". Matched against the official UK Parliament Members register; the closest match is used.", "default": [ "Keir Starmer" ], "items": { "type": "string" } }, "mpNamesText": { "title": "MP names (one per line or comma-separated)", "type": "string", "description": "Alternative to the list above for pasting many names at once, e.g. from a spreadsheet column. One name per line or separated by commas; combined with mpNames and de-duplicated.", "default": "" }, "categories": { "title": "Limit to these interest categories (optional)", "type": "array", "description": "Leave empty to watch ALL registered interest categories. Otherwise pick which categories of the Register of Members' Financial Interests to check, e.g. just Shareholdings and Land and property.", "items": { "type": "string", "enum": [ "employment_and_earnings", "donations", "gifts_uk", "visits_abroad", "gifts_abroad", "land_and_property", "shareholdings", "miscellaneous", "family_employed", "family_lobbying" ], "enumTitles": [ "Employment and earnings", "Donations and support for activities as an MP", "Gifts, benefits and hospitality (UK sources)", "Visits outside the UK", "Gifts and benefits from sources outside the UK", "Land and property", "Shareholdings", "Miscellaneous", "Family members employed", "Family members engaged in third-party lobbying" ] }, "default": [] }, "maxConcurrency": { "title": "Max concurrent MP lookups", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many MPs to check in parallel against the official Parliament APIs. Higher is faster but more likely to hit rate limits; 3 is a safe default.", "default": 3 } } }, "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 } } } } } } } } } }