# UK Government Data API (`lentic_clockss/uk-data-search`) Actor Search 31 UK government data sources — Charity Commission, ICO register, planning applications, NHS health directories, 13 tribunal court decisions (employment, tax, immigration), and public procurement (Contracts Finder, Find a Tender, Scotland, Wales). - **URL**: https://apify.com/lentic\_clockss/uk-data-search.md - **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community) - **Categories:** Lead generation, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## UK Government Data Search Search **31 official UK government data sources** in a single API call — Charity Commission register, ICO data protection register, planning applications, NHS health directories, 13 tribunal and court decision databases (employment, tax, immigration, property), and public procurement across England, Scotland, and Wales. All data from official UK government portals through the SIP Public Data Gateway. ### What is UK Government Data Search? UK Government Data Search is an Apify Actor that queries official UK government databases across business, construction, health, legal, and procurement domains. Instead of navigating gov.uk, NHS, Find Case Law, Contracts Finder, and devolved administration portals separately, you search them all at once. The Actor calls the **SIP Public Data Gateway** — a unified API that normalizes responses from 31 UK data products. No browser, no scraping — just HTTPS API calls. ### Why use UK Government Data Search? - **One search, 31 sources** — Query charity registers, planning applications, NHS directories, tribunal decisions, and procurement notices simultaneously - **Official government data** — All sources are public databases from UK government, NHS, and devolved administrations - **Deepest UK legal coverage** — 13 tribunal and court decision databases spanning employment, tax, immigration, property, transport, and information rights - **All-nations procurement** — Contracts Finder (England), Find a Tender, Public Contracts Scotland, and Sell2Wales in one search - **Post-Brexit independent data** — UK-specific sources separate from EU databases #### Use cases | Who | What | |-----|------| | **Compliance teams** | Search Charity Commission register, ICO fee payers, and tribunal decisions | | **Legal professionals** | Query 13 tribunal databases for employment, tax, immigration, and property decisions | | **Property developers** | Access planning applications, planning data entities, and construction safety KPIs | | **NHS suppliers** | Search NHS organization directories, service listings, and health data catalogs | | **Government contractors** | Monitor procurement across England, Scotland, and Wales in one search | | **Researchers** | Access UKHSA dashboards, Public Health Scotland data, and NHSBSA open data | ### What data can UK Government Data Search extract? | Source | Data type | Example fields | |--------|-----------|----------------| | Charity Commission | Registered charities and trustees | charity_name, number, income, activities | | ICO fee payers | Data protection registered organizations | name, registration_number, tier | | PlanIt applications | UK planning applications | reference, address, status, decision | | Employment tribunal | Employment tribunal decisions | case_name, date, outcome | | Tax tribunal | Tax and chancery decisions | case_name, judge, date | | Immigration tribunal | UTIAC immigration decisions | case_name, country, date | | Find Case Law | Court judgments and decisions | case_name, court, neutral_citation | | NHS services | NHS service directory | service_name, type, location | | Contracts Finder | English public procurement (OCDS) | title, buyer, value, deadline | | Find a Tender | UK procurement notices (OCDS) | title, authority, cpv_code | | Public Contracts Scotland | Scottish procurement | title, buyer, value | | Sell2Wales | Welsh procurement notices | title, buyer, deadline | ### How to search UK data 1. Open the Actor in Apify Console 2. Enter search terms (e.g. "Oxfam", "London", "employment dismissal", "NHS trust") 3. Select data categories — business, construction, and health are on by default 4. Click **Start** — the Actor queries all enabled sources in parallel 5. Download results as JSON, CSV, or Excel #### Example input ```json { "searchTerms": ["Oxfam", "British Red Cross"], "includeBusiness": true, "includeConstruction": false, "includeHealth": false, "includeLegal": false, "includeProcurement": false, "maxResultsPerSource": 50 } ```` ### Output ```json { "charity_name": "OXFAM", "charity_number": "202918", "income": "367800000", "activities": "Relief of poverty", "_product_id": "uk_charity_commission_register", "_source": "charity_commission_register", "_search_term": "Oxfam", "_collected_at": "2026-04-08T14:00:00Z" } ``` ### How much does it cost? Pay-per-event pricing at $2.00 per 1,000 records returned. - **Charity lookup** (1 term, business only): ~$0.01–0.02 - **Full legal scan** (3 terms, all 31 sources): ~$0.50–3.00 No browser overhead. Control costs with `maxResultsPerSource`. ### Data sources (31 UK products) | Category | Sources | Count | |----------|---------|-------| | Business & charity | Charity Commission (register/trustees), ICO fee payers | 3 | | Construction | PlanIt applications, Planning Data, HSE RIDDOR KPIs, Camden street works | 4 | | Health & NHS | NHS services/ODS, NHSBSA, UKHSA, Public Health Scotland, data.gov health/NHS catalogs | 7 | | Legal & tribunals | Employment (tribunal/appeal), tax/chancery, immigration, information rights, property, transport, charity, administrative appeals, Find Case Law (search/XML), Find Court | 13 | | Procurement | Contracts Finder, Find a Tender, Public Contracts Scotland, Sell2Wales | 4 | ### FAQ **Does this cover Scotland and Wales?** Yes. Public Contracts Scotland and Sell2Wales are included for procurement. Public Health Scotland is included for health data. Legal sources cover UK-wide tribunals. **How is this different from EU data?** Post-Brexit, UK operates independent regulatory systems. This Actor covers UK-specific sources (Charity Commission, NHS, UK tribunals, Contracts Finder) that are not part of EU databases. **Can I search tribunal decisions by case type?** Yes. Use specific legal terms (e.g. "unfair dismissal", "VAT", "asylum") with the Legal toggle enabled to search across all 13 tribunal databases. ### Use as MCP Tool (AI Agent Integration) This Actor works as an MCP tool — AI agents (Claude, GPT, Cursor) can discover and run it automatically. #### Quick setup (Claude Desktop / Cursor / VS Code) Add to your MCP config: ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com", "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" } } } } ``` Then ask your AI: *"Search for Oxfam in UK government databases"* #### Direct API call ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("lentic_clockss/uk-data-search").call( run_input={"searchTerms": ["Oxfam"], "maxResultsPerSource": 50} ) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) ``` ### Other Data API Actors - [EU Business & Company Registry API](https://apify.com/lentic_clockss/eu-business-data-search) - [France Government Data API](https://apify.com/lentic_clockss/france-data-search) - [US Business Entity Data API](https://apify.com/lentic_clockss/us-business-entity-search) - [Australia Government Data API](https://apify.com/lentic_clockss/australia-data-search) # Actor input Schema ## `searchTerms` (type: `array`): Keywords to search (e.g. 'Oxfam', 'London', 'employment tribunal', 'NHS'). Each term is searched across all enabled UK data sources in parallel. ## `includeBusiness` (type: `boolean`): Search Charity Commission register and trustees, and ICO Data Protection Fee Payers register (3 sources). ## `includeConstruction` (type: `boolean`): Search PlanIt planning applications, Planning Data entities, HSE construction RIDDOR KPIs, and Camden street works register (4 sources). ## `includeHealth` (type: `boolean`): Search NHS service directories, ODS organization data, NHSBSA open data, UKHSA dashboard, Public Health Scotland, and data.gov health/NHS dataset catalogs (7 sources). ## `includeLegal` (type: `boolean`): Search 13 UK tribunal and court decision databases: employment, tax, immigration (UTIAC), information rights, property, transport, charity, administrative appeals, and Find Case Law (13 sources). ## `includeProcurement` (type: `boolean`): Search Contracts Finder, Find a Tender (OCDS), Public Contracts Scotland, and Sell2Wales procurement notices (4 sources). ## `maxResultsPerSource` (type: `integer`): Maximum records to return per data source (gateway caps at 200). ## Actor input object example ```json { "searchTerms": [ "Oxfam" ], "includeBusiness": true, "includeConstruction": true, "includeHealth": true, "includeLegal": false, "includeProcurement": false, "maxResultsPerSource": 50 } ``` # Actor output Schema ## `records` (type: `string`): Dataset containing business, health, legal, and procurement data from 31 UK government sources. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchTerms": [ "Oxfam" ] }; // Run the Actor and wait for it to finish const run = await client.actor("lentic_clockss/uk-data-search").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchTerms": ["Oxfam"] } # Run the Actor and wait for it to finish run = client.actor("lentic_clockss/uk-data-search").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchTerms": [ "Oxfam" ] }' | apify call lentic_clockss/uk-data-search --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=lentic_clockss/uk-data-search", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "UK Government Data API", "description": "Search 31 UK government data sources — Charity Commission, ICO register, planning applications, NHS health directories, 13 tribunal court decisions (employment, tax, immigration), and public procurement (Contracts Finder, Find a Tender, Scotland, Wales).", "version": "0.1", "x-build-id": "wBhjJ8efwCk1rKdw5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_clockss~uk-data-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_clockss-uk-data-search", "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/lentic_clockss~uk-data-search/runs": { "post": { "operationId": "runs-sync-lentic_clockss-uk-data-search", "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/lentic_clockss~uk-data-search/run-sync": { "post": { "operationId": "run-sync-lentic_clockss-uk-data-search", "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": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search (e.g. 'Oxfam', 'London', 'employment tribunal', 'NHS'). Each term is searched across all enabled UK data sources in parallel.", "items": { "type": "string" } }, "includeBusiness": { "title": "Include business & charity data", "type": "boolean", "description": "Search Charity Commission register and trustees, and ICO Data Protection Fee Payers register (3 sources).", "default": true }, "includeConstruction": { "title": "Include construction & planning data", "type": "boolean", "description": "Search PlanIt planning applications, Planning Data entities, HSE construction RIDDOR KPIs, and Camden street works register (4 sources).", "default": true }, "includeHealth": { "title": "Include NHS & health data", "type": "boolean", "description": "Search NHS service directories, ODS organization data, NHSBSA open data, UKHSA dashboard, Public Health Scotland, and data.gov health/NHS dataset catalogs (7 sources).", "default": true }, "includeLegal": { "title": "Include tribunal & court decisions", "type": "boolean", "description": "Search 13 UK tribunal and court decision databases: employment, tax, immigration (UTIAC), information rights, property, transport, charity, administrative appeals, and Find Case Law (13 sources).", "default": false }, "includeProcurement": { "title": "Include public procurement", "type": "boolean", "description": "Search Contracts Finder, Find a Tender (OCDS), Public Contracts Scotland, and Sell2Wales procurement notices (4 sources).", "default": false }, "maxResultsPerSource": { "title": "Max results per source", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum records to return per data source (gateway caps at 200).", "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 } } } } } } } } } } ```