🔎 UK Food Hygiene Compliance Roster

One registry_record per UK food-hygiene establishment — the COMPLIANCE-REFRESH roster for underwriting/ops: normalized rating band, rating staleness (days), pending-rating and component-risk flags, all-UK INCLUDING Scotland's FHIS vocabulary reconciled against FHRS. vs uk-food-hygiene-prospect-finder: compliance refresh + risk flags for underwriting, NOT prospecting lists. vs the store comparators: all-UK bulk + Scotland (FHIS) where they cap exports and skip Scotland.

Public, robots-honoured.

Output is one uk_food_hygiene_compliance row per result; billing is pay-per-event, the value event being one registry record (a $0.02 start fee per run, then $0.02 per registry record). Source: api.ratings.food.gov.uk.

No login, no API key and no CAPTCHA solving are involved: the source is read logged-out with an identified contact User-Agent.

📊 Sample Output

Real rows from run ZbKGrSNee8pTtpTHr on build 0.1.4 (2026-09-18), the same input as the Quick start below — every value is as the source published it (emails masked, long text shortened):

la_business_id	business_name	business_type	rating_value_raw	rating_band	rating_key
EHDC15239	(CURATED) MOROCCAN MARKET	Retailers - other	Improvement Required	improvement_needed	fhis_improvement_required_en-GB
EHDC12463	1 & 30 DONALD DEWAR COURT	Hospitals/Childcare/Caring Premises	Pass	compliant	fhis_pass_en-GB
EHDC13206	1DS	Pub/bar/nightclub	Awaiting Inspection	awaiting	fhis_awaiting_inspection_en-GB
EHDC9793	210 BISTRO	Restaurant/Cafe/Canteen	Pass	compliant	fhis_pass_en-GB
EHDC4774	22 CLUB	Pub/bar/nightclub	Pass	compliant	fhis_pass_en-GB
EHDC15957	2BP PIZZA	Takeaway/sandwich shop	Improvement Required	improvement_needed	fhis_improvement_required_en-GB
EHDC16147	33 STREET FOOD	Other catering premises	Awaiting Inspection	awaiting	fhis_awaiting_inspection_en-GB
EHDC8497	3rd HOUSE GUESTHOUSE	Hotel/bed & breakfast/guest house	Pass	compliant	fhis_pass_en-GB

The run finished with the status message: NORMAL: 50 unique rows (0 duplicates collapsed). billable=50

✅ What you get

Each row is flat JSON with these fields (from the dataset schema and the sample run; a field the source does not publish for a given row is null):

• record_type (string) — e.g. uk_food_hygiene_compliance
• fhrsid (string/null) — e.g. 1608170
• la_business_id (string/null) — e.g. EHDC15239
• business_name (string/null) — e.g. (CURATED) MOROCCAN MARKET
• business_type (string/null) — e.g. Retailers - other
• business_type_id (string/null) — e.g. 4613
• scheme_type (string/null) — e.g. FHIS
• rating_value_raw (string/null) — e.g. Improvement Required
• rating_band (string/null) — e.g. improvement_needed
• rating_key (string/null) — e.g. fhis_improvement_required_en-GB
• rating_date (string/null) — e.g. 2023-07-28
• rating_staleness_days (integer/null) — e.g. 1148
• new_rating_pending (boolean/null) — e.g. False
• hygiene_score (string/null) — null in every sample row
• structural_score (string/null) — null in every sample row
• management_score (string/null) — null in every sample row
• component_risk_flag (boolean/null) — null in every sample row
• local_authority_code (string/null) — e.g. 760
• local_authority_name (string/null) — e.g. Aberdeen City
• region (string/null) — e.g. Scotland
• post_code (string/null) — e.g. AB25 1HZ
• address (string/null) — e.g. George Street, Aberdeen
• longitude (string/null) — e.g. -2.10076438
• latitude (string/null) — e.g. 57.14955652
• source (string/null) — e.g. uk-food-hygiene-compliance-roster
• release_date (string/null) — null in every sample row
• source_url (string/null) — e.g. https://api.ratings.food.gov.uk/Authorities
• observed_at (string/null) — e.g. 2026-09-18T19:46:54Z
• terminal (string/integer/null) — null in every sample row
• reported_total (string/integer/null) — null in every sample row
• raw_seen (string/integer/null) — null in every sample row
• duplicates (string/integer/null) — null in every sample row
• unique_found (string/integer/null) — null in every sample row
• delivered (string/integer/null) — null in every sample row
• scope (string/integer/null) — null in every sample row
• note (string/integer/null) — null in every sample row
• license (string/integer/null) — null in every sample row
• attribution (string/integer/null) — null in every sample row

What you get

One registry_record per record, deduplicated on the source-native id. Fields the source does not publish are honest null. A run_receipt row carries the source URL, scope, reconciliation counts, and delivered/duplicate totals.

⚙️ Sample inputs

1. Quick start — the Store example (this is what the sample above came from)

{
  "maxRecords": 50
}

The sample run charged exactly: 4 × $0.02 apify-actor-start + 50 × $0.02 registry_record = $1.08 on the Free tier — every delivered row was billed.

2. A smaller, narrowed run

{
  "maxRecords": 5
}

Caps the run at 5 rows — about $0.12 on the Free tier ($0.02 start + 5 × $0.02).

3. A full-size run

{
  "maxRecords": 5000
}

Up to 5000 rows (the schema default for maxRecords) — about $100.02 on the Free tier ($0.02 start + 5000 × $0.02) if the source has that many.

🧾 JSON sample record

One real record from run ZbKGrSNee8pTtpTHr, exactly as it lands in the dataset (emails masked, long text shortened):

{
  "record_type": "uk_food_hygiene_compliance",
  "fhrsid": "1608170",
  "la_business_id": "EHDC15239",
  "business_name": "(CURATED) MOROCCAN MARKET",
  "business_type": "Retailers - other",
  "business_type_id": "4613",
  "scheme_type": "FHIS",
  "rating_value_raw": "Improvement Required",
  "rating_band": "improvement_needed",
  "rating_key": "fhis_improvement_required_en-GB",
  "rating_date": "2023-07-28",
  "rating_staleness_days": 1148,
  "new_rating_pending": false,
  "hygiene_score": null,
  "structural_score": null,
  "management_score": null,
  "component_risk_flag": null,
  "local_authority_code": "760",
  "local_authority_name": "Aberdeen City",
  "region": "Scotland",
  "post_code": "AB25 1HZ",
  "address": "George Street, Aberdeen",
  "longitude": "-2.10076438",
  "latitude": "57.14955652",
  "source": "uk-food-hygiene-compliance-roster",
  "release_date": null,
  "source_url": "https://api.ratings.food.gov.uk/Authorities",
  "observed_at": "2026-09-18T19:46:54Z"
}

🔧 How it works

Transport. Plain HTTPS from the Apify platform, no proxy. robots.txt is read first and a disallowed path is never fetched. Every request carries an identified contact User-Agent. Pacing: CRAWL_DELAY=0.0.

Charging. Each registry record is charged at the moment it is pushed (registry_record); a row that fails to charge is not delivered, so the dataset count always equals the charged count.

How it behaves

The 363 local-authority bulk XML files are discovered from the keyless FSA /Authorities API and streamed; each establishment becomes one record with FHRS (0-5) and FHIS (Scotland) ratings reconciled to a comparable band, staleness computed from the rating date, and component scores flagged for risk. Deduped on FHRSID. Bulk-proof: streamed per-authority, memory bounded.

Source

https://api.ratings.food.gov.uk/Authorities

What is not done. No login, no cookie or CAPTCHA bypass, no private or personal-account data, no browser automation.

💰 Pricing example

Event	Free	Bronze	Silver	Gold
Actor Start (apify-actor-start)	$0.02	$0.02	$0.02	$0.02
Registry Record (registry_record)	$0.02	$0.02	$0.02	$0.01

Worked at the live Free-tier price:

• 8 registry records: $0.02 start + 8 × $0.02 = $0.18
• 25 registry records: $0.02 start + 25 × $0.02 = $0.52
• 5000 registry records: $0.02 start + 5000 × $0.02 = $100.02

A run that delivers zero rows charges the $0.02 start fee only. A BLOCKED run (source refused) fails loud and charges no value event. The start fee is charged once per GB of run memory; the default run memory is 4096 MB.

Yield on the sample run: NORMAL: 50 unique rows (0 duplicates collapsed). billable=50. maxRecords is a hard ceiling on what is delivered and billed, never a target.

⚖️ Legal & ToS

This actor reads public, logged-out pages and feeds published by api.ratings.food.gov.uk. It collects only what the source publishes to any visitor, keeps to the source's robots rules (checked on every run), identifies itself with a contact User-Agent, and does not access accounts, private data or anything behind authentication. Use the output in line with the source's terms and your local law; the intended use is B2B research and monitoring.

❓ FAQ

Q: Do I need an API key or a login?
A: No. The source (api.ratings.food.gov.uk) is read logged-out; the input schema has no key field and the actor carries no secrets.

Q: Why did my run return 0 rows?
A: Read the run's status message. GENUINE_EMPTY means the source was read and had nothing in scope for your input; BLOCKED means the source refused and the run failed without billing a value event — retry later or narrow the input. A zero-row run bills the start fee only.

Q: How many rows can one run return?
A: Up to maxRecords (default 5000). Raise the cap for a bigger run; you pay per delivered row.

Q: How fresh is the data?
A: Every run reads the source live at run time; nothing is cached between runs. Put it on a schedule for a continuous feed.

Q: What formats can I export?
A: The dataset downloads as JSON, CSV, Excel, XML or RSS from the run's Dataset tab or the Apify API, and any run can push to a webhook or integration.

Q: How is this different from the other company registry checks actors?
A: Same output shape and billing model; this one covers api.ratings.food.gov.uk. The siblings under Related Actors cover the other sources or slices — run several on one schedule for a combined feed.

Q: Are there rate limits?
A: The actor paces itself against the source (CRAWL_DELAY=0.0) and honours its robots rules; there is no per-buyer limit beyond your Apify plan's concurrency.

🆘 Troubleshooting

• Run FAILED with BLOCKED → the source refused the request or changed its page shape → nothing was billed beyond the start fee; retry after a while, and if it persists open an Issue with the run id.
• Status says CAPPED → your cap (maxRecords) was reached → raise it for a bigger run.
• Input validation error on start → a field is outside the schema's allowed values → start from the Quick start block and change one field at a time.
• Run TIMED-OUT → a very wide request on a slow day → raise the run timeout in Run options or narrow the input; what was delivered before the timeout is still in the dataset.

🔗 Related Actors

• Texas Franchise Taxpayer Status Check — Resolves Texas taxpayers against the Comptroller's official franchise-tax account-status service — by 11-digit taxpayer number, SOS file number or ex…
• UK Charity Eligibility Lookup — Charity Commission register — Look up UK charities on the official Charity Commission register — one verdict per query with number, name and status. No API key; pay per answer
• UK Companies House Filing and Control Watch — Companies House filing history AND persons with significant control for the companies you name, in one cell: a new filing appearing, and a PSC being…
• UK Food Hygiene Establishment Check — Check UK establishments against the official FSA food-hygiene ratings API — one official answer per identifier (FHRSID or name): current hygiene rati…
• UK Food Hygiene Prospect Finder — FSA Ratings — Prospecting lists of UK food businesses from the FSA's own public ratings API: rating, scores, address and authority contact per establishment
• UK Gambling Business Licence Roster — One structured registryrecord per record from the Gambling Commission official business-licence-register businesses CSV (~2,664 accounts, robots allo…
• 🏢 About NexGenData — NexGen Watch is NexGenData's fleet of 256 public monitoring and lookup actors built on official sources, pay-per-result. Browse the catalog at apify.com/nexgenwatch.

⭐ Found this useful?

If this actor saved you a manual check, a quick review on the Apify Store helps other teams find it. Feature request or a source that changed? Open it from the Issues tab — every one is read.