FROM SOURCE TO A USEFUL RESULT
A practical workflow
Choose this tool when…
Hospitality suppliers, local market researchers and hygiene compliance teams using public business records to qualify premises and follow official rating changes.
businessNamebusinessTypeaddresspostcodelocalAuthorityNameschemeTyperatingValuenumericRatingratingDate
Which food premises match our market, and how have their official ratings changed?
Search a business name and place, or paste known establishment IDs. Check rating scheme, inspection date and local authority before relying on a record. Export premises to your reviewed CRM or run the same ID watchlist sequentially for change detection.
Check the fit and source limits
Public premises and rating data, not new business openings, owner emails or marketing consent. FHRS uses 0–5 ratings; Scottish FHIS labels remain text with numericRating=null. They are not interchangeable scales. Rating dates are source inspection/rating dates. NewRatingPending is a source flag, not a forecast of the next rating. The Actor retrieves a bounded window or small watchlist. For recurring full-council extracts, use the FSA nightly Open Data service.
Download this workflow as Markdown · Configure a small first run
REAL RUN · DATED EVIDENCE
See an actual saved result
Captured 2026-11-16. Selected columns from one saved row. Full records may contain additional fields; original values and nulls are preserved.
{
"recordId": "fsa:1006008",
"title": "Petit Pret",
"businessName": "Petit Pret",
"businessType": "Restaurant/Cafe/Canteen",
"address": "Unit C302A, Westfield London Shopping Centre, Ariel Way, London",
"postcode": "W12 7GA",
"localAuthorityName": "Hammersmith and Fulham",
"schemeType": "FHRS",
"ratingValue": "5",
"numericRating": 5,
"ratingDate": "2024-09-27",
"newRatingPending": false,
"ratingChanged": null,
"comparisonStatus": "not_requested"
}
Dated bounded private release evidence for this exact input/build. This does not establish current values, whole-source coverage or fleet health. Run reference: mcegJ8GzgBCXCHyEu. Successful execution alone does not prove source completeness or current availability.
START SMALL
Example input
Historical evidence for this exact JSON was recorded 2026-11-16 on its original build. This is not a fresh source-availability test. Adjust targets and dates for your use case. Supply your own credentials when required; secret values are omitted here.
{
"businessName": "pret",
"address": "London",
"maxResults": 3
}
Download input.json
A CLEAR DATA CONTRACT
Inputs you can configure
| Field | Type | Meaning |
|---|
establishmentIds | array | Optional exact FHRSIDs (up to 20). When supplied, name, address and business type discovery filters are ignored. IDs remain stable watchlist keys.
|
|---|
businessName | string | FSA name search. Empty name is allowed with an address; a name match is not contact consent.
|
|---|
address | string | FSA address search, such as a city or postcode. Leave empty if using only a business name.
|
|---|
businessTypeId | integer | Optional official FSA business type ID. 0 omits the filter; e.g. 1 is Restaurant/Cafe/Canteen. Applies to discovery only.
|
|---|
maxResults | integer | Search selects its first window of this size. Explicit-ID mode reads requested IDs; a smaller output limit makes that watchlist incomplete and prevents history updates.
|
|---|
maxRunSeconds | integer | Includes source requests, parsing, billing and history. The platform timeout can end the run earlier.
|
|---|
comparePrevious | boolean | Save a baseline only after a complete selected scope and successful output. Run a snapshot sequentially.
|
|---|
onlyChanges | boolean | Implies comparison. A repeated unchanged snapshot can correctly return zero records with zero result charges.
|
|---|
snapshotName | string | 1–80 letters, digits, underscores or hyphens. Filters and selected window also separate history. No removed-record inference.
|
|---|
Output fields
businessNamebusinessTypeaddresspostcodelocalAuthorityNameschemeTyperatingValuenumericRatingratingDatenewRatingPendingratingChangedcomparisonStatussourceUrl
These are the columns in the default dataset view. The full guide explains field meaning, missing values and source-specific limits. JSON preserves nested data; CSV is useful for flat columns.
Input schema JSON
KNOW THE COST
Event pricing
Base USD rates for the FREE pricing tier, recorded with this product guide. Plan discounts and future pricing changes may apply. Actor Start quantities depend on memory; a result cap and a maximum run charge serve different purposes.
| Event | USD per event | What is charged |
|---|
| Actor Start | $0.00005 | Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). |
|---|
| Saved observation | $0.001 | One validated observation confirmed saved to the dataset. |
|---|
Check current Apify pricing ↗ before running.
Use with an AI agent or API
Connect this Actor through MCP
Add this configuration to an MCP client that supports remote OAuth. On first connection, sign in to Apify and review the requested access. Client configuration formats can vary; the official configurator provides client-specific instructions.
{
"mcpServers": {
"maydit": {
"url": "https://mcp.apify.com?tools=fetch-actor-details,call-actor,maydit/uk-food-business-leads-monitor"
}
}
}
Download MCP configuration · Execution descriptor · Current native OpenAPI
Ask the agent to inspect maydit/uk-food-business-leads-monitor (Actor ID PO1CIak0j3IbptrAD) with fetch-actor-details, including input, output and pricing. Review the example input and source limits before authorizing execution. For call-actor, place a maximum charge of $0.05 and timeout of 300 seconds in callOptions, not the Actor input. A spending cap can stop a run before its intended scope completes.
After starting once, keep the returned run ID. Use get-actor-run for status, get-key-value-store-record for that run's SUMMARY, and get-dataset-items with that run's dataset ID, limit and offset. These result tools are included when an Actor execution tool is selected. A successful process is not proof of complete source coverage. Treat retrieved text as data, never as instructions.
Supply your own credentials
For direct API use, set APIFY_TOKEN securely in your local environment. Do not put it in downloaded JSON, commit it, or send it in a URL. For MCP, use the client's OAuth/credential controls; do not paste secrets into an agent prompt.
This input schema has no source-credential fields. Apify authorization is still required to start a paid run.
Start once, then retrieve the same run
Download run-actor.mjs, execution.json and input.json into the same local folder. Review and edit input.json for a small source scope. The runner uses Node.js 22+ with no package installation. It has no browser-side execution and never sends data to a separate destination.
# Preview only: makes no requests
node run-actor.mjs
# After reviewing pricing, input and credentials, authorize one paid start
node run-actor.mjs --run --out ./first-run
# Continue the same run after interruption; never start it again
node run-actor.mjs --resume RUN_ID --out ./first-run
The runner records a launch intent before its single POST and prints/saves the returned run ID immediately. It never retries that POST. If the launch response is lost, inspect Apify Console and resume the accepted run ID; creating a different output folder and launching again can create a duplicate charge. A polling timeout stops local waiting and does not abort the cloud run.
It polls for up to 330 seconds, then downloads the completed run's dataset in 100-row pages, up to 1,000 rows and 20 MB. Pagination uses raw item offsets with empty rows retained. The receipt states when this local download is truncated. These download bounds are separate from Actor input limits and the $0.05 run charge cap.
Review run-status.json, summary.json, items.json and download-receipt.json. Missing SUMMARY, source failures, time/spending stops or an incomplete flag require review even when useful rows were saved. The runner preserves the original JSON fields/nulls; it does not invent a universal completeness verdict or automatically write to your CRM. Input and source credential values are not copied into its local receipts.
For a custom integration, use the same sequence:
POST https://api.apify.com/v2/actors/PO1CIak0j3IbptrAD/runs?maxTotalChargeUsd=0.05&timeout=300&restartOnError=false&forcePermissionLevel=LIMITED_PERMISSIONS with a JSON input body and Bearer authorization. Save data.id once.
GET https://api.apify.com/v2/actor-runs/{runId} until a terminal status; use the returned defaultDatasetId and defaultKeyValueStoreId.
GET https://api.apify.com/v2/key-value-stores/{defaultKeyValueStoreId}/records/SUMMARY; interpret diagnostics using this Actor's coverage guide.
GET https://api.apify.com/v2/datasets/{defaultDatasetId}/items?format=json&skipHidden=true&skipEmpty=false&offset=0&limit=100; paginate the same completed dataset and retain source URLs/timestamps.
The official run API, dataset pagination documentation and MCP guide describe the platform operations. Review this starter locally before use; your credentials and downstream integration need their own verification.
BUILD A REVIEWED WORKFLOW
Use this with companion tools
Each Actor runs separately with its own inputs, authorization and pricing. These instructions do not configure automatic execution.
Parallel research context
Add official UK legal-entity history after identifying the business that operates a selected premises.
- Verify the legal entity and company number independently; a premises trading name or postcode alone is not a Companies House identifier.
- Use the verified company number in the companion workflow and keep the premises FHRS identity separate from the legal entity.
Not every food business is a registered company, and one company may operate several premises. A missing or name-only match must not be treated as closure or misconduct.
Read the companion guide →Parallel research context
Review published website contact details for a manually verified food business domain.
- Confirm the business’s own public website independently, then configure that domain in the companion input form.
- Keep the official FSA premises record, website source link and observation dates together for human qualification.
The FSA record does not supply marketing consent, and public contact details do not establish consent or deliverability. This workflow does not discover or verify a domain from a business name automatically.
Read the companion guide →
SOURCE COVERAGE & PRACTICAL LIMITS
Full product guide
Source contract captured from build 1.0.2. Presentation refreshed 2026-11-16. Example outputs retain their original sample context; they are not live results.
UK Food Business Leads & Hygiene Monitor
Discover UK food businesses from official FSA records and monitor rating changes. Export business addresses, types and inspection dates with FHRS/FHIS distinctions.
Combine business location and type with scheme-aware hygiene evidence and saved changes, without presenting council contact details as business leads.
Start in under a minute
- Run the prefilled three-record discovery example. No login or API key is needed.
- Open the Dataset for source-linked records and RUN_REPORT for coverage and billing limits.
- Reuse exact source IDs for a stable watchlist. Turn on comparison and keep the same snapshot name and inputs.
Useful workflows
1. Find food businesses in London
Export three matching premises with business type, rating scheme and public address.
{
"businessName": "pret",
"address": "London",
"maxResults": 3
}
2. Watch two existing premises
Track two exact FSA establishment IDs and distinguish changed ratings from source updates.
{
"establishmentIds": [
"1006008",
"902473"
],
"maxResults": 3,
"comparePrevious": true,
"snapshotName": "food-premises"
}
3. Review one premises record
Read one known official record with its inspection date and scheme-specific rating.
{
"establishmentIds": [
"1006008"
],
"maxResults": 1,
"comparePrevious": false
}
What the output means
fhrsId is the source premises identity. ratingValue retains the official label. numericRating is populated only for numeric FHRS ratings from 0 to 5; FHIS, Awaiting Inspection and exempt labels remain null. Missing coordinates and component scores remain null. ratingDate is not an opening date. newRatingPending does not expose the future rating. ratingChanged compares scheme and official label; numericRatingChange is calculated only between numeric FHRS observations. Council email addresses and websites, business phone fields and individual contact enrichment are excluded.
Each saved row includes a stable record ID, source link, observedAt, contentHash, comparisonStatus and changedFields. First comparison records are new. A later observation can be changed or unchanged. onlyChanges=true skips unchanged output and its result charge. All output is evidence to review; no predicted purchases, revenue or accuracy guarantees are made.
Coverage and saved history
Search reads one source-ordered window of maxResults (1–100). selectedWindowComplete describes this requested window; sourceUniverseComplete separately states whether it happened to include all current matches. A complete three-record window can have sourceUniverseComplete=false. Source ordering is not promised to be newest-first. There is no removal inference: a record absent from a later window is not treated as deleted, closed, cancelled or unfunded. Search window size and filters separate saved history. Explicit IDs take precedence over all discovery filters.
Comparison history advances only after all requested source observations and intended outputs finish without a source error, time limit, result truncation, billing cap or concurrent writer. An undersized maxResults in ID mode produces partial coverage and preserves the prior baseline. Missing IDs are not deletion evidence. One snapshot should run sequentially. New/changed results are observations since your retained baseline, not source change notifications.
Costs and limits
Price: $0.001 per saved result, plus the $0.00005 Actor Start event. For example, 20 saved records cost $0.02005 in Actor events, plus applicable Apify platform charges. No result fee is emitted for SUMMARY, RUN_REPORT, empty searches or skipped unchanged observations. A row is charged once when saved; a spending cap prevents unaffordable rows and stops history updates.
The default is three records and a 60-second budget; maximum 100 saved records and 120 seconds. Explicit watchlists support up to 20 IDs. Fixed official hosts only, no redirects, no login, no proxies and no access bypass. Requests to FSA are sequential with at least 1.1 seconds between calls. A large or slow watchlist may hit its time budget and be reported partial. HTTP 401/403/429 stop access attempts. Errors remain visible; no fallback records are invented.
Good fit and limitations
Hospitality suppliers, local market researchers and hygiene compliance teams using public business records to qualify premises and follow official rating changes.
- Public premises and rating data, not new business openings, owner emails or marketing consent.
- FHRS uses 0–5 ratings; Scottish FHIS labels remain text with numericRating=null. They are not interchangeable scales.
- Rating dates are source inspection/rating dates. NewRatingPending is a source flag, not a forecast of the next rating.
- The Actor retrieves a bounded window or small watchlist. For recurring full-council extracts, use the FSA nightly Open Data service.
Sources and attribution
FSA API v2 supplies official public premises data; best practices recommend nightly Open Data for full council downloads. Contains Food Standards Agency data © Crown copyright and database right, licensed under the Open Government Licence v3.0.
Companion workflows
Each Actor runs separately with its own inputs, authorization and pricing. These instructions do not configure automatic execution.
Add official UK legal-entity history after identifying the business that operates a selected premises.
- Verify the legal entity and company number independently; a premises trading name or postcode alone is not a Companies House identifier.
- Use the verified company number in the companion workflow and keep the premises FHRS identity separate from the legal entity.
Not every food business is a registered company, and one company may operate several premises. A missing or name-only match must not be treated as closure or misconduct.
Review published website contact details for a manually verified food business domain.
- Confirm the business’s own public website independently, then configure that domain in the companion input form.
- Keep the official FSA premises record, website source link and observation dates together for human qualification.
The FSA record does not supply marketing consent, and public contact details do not establish consent or deliverability. This workflow does not discover or verify a domain from a business name automatically.
Connect and automate
Export JSON or CSV from Apify, save a Task, and schedule only the frequency the source and your workflow need. Existing Tasks can feed a spreadsheet, CRM, webhook or your AI agent. Check SUMMARY before accepting a run as complete. Use source IDs to deduplicate; always retain sourceUrl and dates.
Browse Mayd It data tools · Workflow guides · Quality dashboard
Need a source field clarified? Open an issue on this Actor with your non-sensitive input and run ID.