# Uk Food Hygiene Failures Monitor (`devon_gtme/uk-food-hygiene-failures-monitor`) Actor Catch UK food hygiene rating failures the moment they're published, straight from the official Food Standards Agency (FHRS) database. This is not a lookup tool — it's a trigger monitor: run it weekly and get only what's genuinely new. - **URL**: https://apify.com/devon\_gtme/uk-food-hygiene-failures-monitor.md - **Developed by:** [Devon Kellar](https://apify.com/devon_gtme) (community) - **Categories:** Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Food Hygiene Failures Monitor — FSA Ratings Trigger Catch UK food hygiene rating **failures the moment they're published**, straight from the official Food Standards Agency (FHRS) database. This is not a lookup tool — it's a trigger monitor: run it weekly and get only what's genuinely new. ### Why this matters A 0, 1, or 2-star hygiene rating is one of the strongest B2B trigger events in local commerce. The business needs to act *now* — before their next inspection, before the bad review cycle starts, before a regular customer sees the sticker in the window. - **Pest control companies** — a hygiene failure often means a pest problem the business hasn't found yet - **Deep cleaning companies** — the fastest-converting cold outreach angle in the industry: "we saw your rating, here's how we fix it before the re-inspection" - **Food safety consultants** — pre-qualified leads who are legally required to act - **Hospitality insurance & compliance suppliers** — early signal of operational risk ### What you get Each record includes: | Field | Example | |---|---| | `businessName` | Everydays Restaurant | | `ratingValue` | 0 | | `ratingDate` | 2025-12-12 | | `businessType` | Restaurant/Cafe/Canteen | | `localAuthority` | Croydon | | `fullAddress` | 136 North End, Croydon, CR0 1UE | | `latitude` / `longitude` | For mapping and territory sorting | | `ratingUrl` | Direct link to the official rating page | Sub-scores (`hygieneScore`, `structuralScore`, `managementScore`) are included too — a low structural score points at a different sales angle (equipment/fit-out) than a low hygiene score (cleaning/pest). ### A note on data freshness FSA's published ratings typically lag **2-4 weeks** behind the actual inspection date — this is a delay in the FSA's own data, not this actor. Running with `daysBack: 7` will often return very few results. **30 days is the recommended default** for reliable volume; run monthly rather than weekly if you want consistent batches. ### Typical usage - **Monthly national failure feed:** default settings (ratings 0-2, last 30 days) and [schedule](https://docs.apify.com/platform/schedules) monthly - **Territory monitor:** set `localAuthorities` to your operating area — e.g. `["Croydon", "Bromley", "Lewisham"]` - **Segment by premises type:** set `businessTypes` to `["Restaurant", "Takeaway"]` or `["Caring Premises", "Hospital"]` for care-sector deep cleaning leads No API key, no login — the FSA's data service is free and official, covering England, Wales, and Northern Ireland. ### Export & integrations Results land in an Apify dataset — export **CSV, Excel, JSON**, or connect Google Sheets, Make, Zapier, Slack, and webhooks via Apify integrations. ### Data source & licence Data comes from the [Food Standards Agency](https://ratings.food.gov.uk/) FHRS open data API. Ratings are public record. This actor is not affiliated with the FSA. --- **Need something more custom?** Enriched buyer contact matching, territory-mapped lead lists, or a fully managed outreach pipeline off this data — message me via my Apify profile and I'll build it. # Actor input Schema ## `ratings` (type: `array`): Which hygiene ratings to fetch. 0-2 are failures (the trigger-worthy ones); 3-5 are passing scores if you want full coverage. ## `daysBack` (type: `integer`): Only include ratings published in the last N days. This is what makes it a 'new failures' monitor rather than a full historical dump — the FSA API returns all-time results, so this filter is applied after fetching. Note: FSA's published data typically lags 2-4 weeks behind the real inspection date, so 7 days often returns very few results — 30 is a safer default for reliable volume. ## `localAuthorities` (type: `array`): Restrict to specific council areas, e.g. 'Croydon', 'Birmingham', 'Manchester'. Leave empty for all of England, Wales, and Northern Ireland. ## `businessTypes` (type: `array`): Filter by business type substring, e.g. 'Restaurant', 'Takeaway', 'Hospital', 'Caring Premises'. Leave empty for all types. ## `maxResults` (type: `integer`): Maximum records to return. ## Actor input object example ```json { "ratings": [ "0", "1", "2" ], "daysBack": 30, "localAuthorities": [], "businessTypes": [], "maxResults": 1000 } ```` # 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 = { "ratings": [ "0", "1", "2" ], "daysBack": 30, "localAuthorities": [], "businessTypes": [], "maxResults": 1000 }; // Run the Actor and wait for it to finish const run = await client.actor("devon_gtme/uk-food-hygiene-failures-monitor").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 = { "ratings": [ "0", "1", "2", ], "daysBack": 30, "localAuthorities": [], "businessTypes": [], "maxResults": 1000, } # Run the Actor and wait for it to finish run = client.actor("devon_gtme/uk-food-hygiene-failures-monitor").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 '{ "ratings": [ "0", "1", "2" ], "daysBack": 30, "localAuthorities": [], "businessTypes": [], "maxResults": 1000 }' | apify call devon_gtme/uk-food-hygiene-failures-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=devon_gtme/uk-food-hygiene-failures-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Uk Food Hygiene Failures Monitor", "description": "Catch UK food hygiene rating failures the moment they're published, straight from the official Food Standards Agency (FHRS) database. This is not a lookup tool — it's a trigger monitor: run it weekly and get only what's genuinely new.", "version": "0.1", "x-build-id": "mMKWYVhbdcfsuthgR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/devon_gtme~uk-food-hygiene-failures-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-devon_gtme-uk-food-hygiene-failures-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/devon_gtme~uk-food-hygiene-failures-monitor/runs": { "post": { "operationId": "runs-sync-devon_gtme-uk-food-hygiene-failures-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/devon_gtme~uk-food-hygiene-failures-monitor/run-sync": { "post": { "operationId": "run-sync-devon_gtme-uk-food-hygiene-failures-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": { "ratings": { "title": "Ratings to Monitor", "type": "array", "description": "Which hygiene ratings to fetch. 0-2 are failures (the trigger-worthy ones); 3-5 are passing scores if you want full coverage.", "items": { "type": "string", "enum": [ "0", "1", "2", "3", "4", "5" ] }, "default": [ "0", "1", "2" ] }, "daysBack": { "title": "Days Back", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only include ratings published in the last N days. This is what makes it a 'new failures' monitor rather than a full historical dump — the FSA API returns all-time results, so this filter is applied after fetching. Note: FSA's published data typically lags 2-4 weeks behind the real inspection date, so 7 days often returns very few results — 30 is a safer default for reliable volume.", "default": 30 }, "localAuthorities": { "title": "Local Authorities", "type": "array", "description": "Restrict to specific council areas, e.g. 'Croydon', 'Birmingham', 'Manchester'. Leave empty for all of England, Wales, and Northern Ireland.", "items": { "type": "string" } }, "businessTypes": { "title": "Business Types", "type": "array", "description": "Filter by business type substring, e.g. 'Restaurant', 'Takeaway', 'Hospital', 'Caring Premises'. Leave empty for all types.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Maximum records to return.", "default": 1000 } } }, "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 } } } } } } } } } } ```