# Singapore NEA Food Hygiene Grades Scraper (`scrapers_lat/singapore-food-hygiene-grades-scraper`) Actor
Scrape Singapore NEA licensed food shops and their hygiene grade (A/B/C/D) from the official data.gov.sg open data portal. Get licensee name, licence number, address, demerit points and suspension dates. Export to JSON, CSV or Excel.
- **URL**: https://apify.com/scrapers\_lat/singapore-food-hygiene-grades-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Business, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## 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
[](https://console.apify.com/actors/O3FcjcRoyh13vmPG7/input)
## Singapore NEA Food Hygiene Grades Scraper
> Pull Singapore NEA licensed food shops together with their official food hygiene grade (A, B, C or D) from the data.gov.sg open data portal. Search by name or address, filter by grade, and export licensee, address, demerit points and suspension dates. No login, no API key.
### What you get
One record per licensed food establishment, straight from the official NEA food shop licence datasets published on data.gov.sg. Built for lead generation, food safety research and market mapping.
- **licenseeName**: the company or person that holds the licence
- **licenceNumber**: the NEA licence number
- **premisesAddress**: the full address of the licensed premises
- **grade**: the NEA food hygiene grade of the premises (A, B, C or D). Grade A is the highest standard of food hygiene and grade D the lowest. Only present for eating establishments.
- **demeritPoints**: demerit points accumulated under NEA's points system (numeric)
- **suspensionStartDate**: start date of any licence suspension, if applicable
- **suspensionEndDate**: end date of any licence suspension, if applicable
- **licenceType**: `eating` or `supermarket`
- **source**: the data source label
- **observedAt**: when this record was collected
Supermarket records add `buildingName`, `blockHouseNumber`, `streetName`, `levelNumber`, `unitNumber` and `postalCode`.
### What is the food hygiene grade?
Singapore's National Environment Agency (NEA) grades licensed eating establishments on food hygiene. The grade reflects the premises' compliance with food safety and cleanliness standards:
- **A**: highest standard of hygiene
- **B**: good
- **C**: average
- **D**: lowest passing standard
The grade in this dataset is the official NEA grade published for each licensed premises.
### How it works
| Input | What it does |
|---|---|
| `licenceType` | Choose `eating` (food shops with a hygiene grade) or `supermarket` (licensed supermarkets). |
| `grade` | Keep only eating establishments with a specific hygiene grade (A, B, C or D). |
| `searchQuery` | Filter by any keyword: licensee name or premises address (for example MCDONALD, a mall name, a street). |
| `sortByNewest` | Return the most recently added licences first. |
| `maxItems` | Cap the number of records collected. |
The data comes from the official Singapore open data portal. Anonymous access is rate limited, so large pulls are paced automatically.
### Use cases
| Use case | Who it is for |
|---|---|
| Build a lead list of licensed food businesses | B2B sales and suppliers to F&B |
| Screen venues by food hygiene grade | Delivery platforms, caterers, event teams |
| Map the food and beverage market by area | Analysts and researchers |
| Monitor suspensions and demerit points | Compliance and food safety teams |
| Enrich a restaurant directory with licence data | Data teams |
### Frequently Asked Questions
**Where does the data come from?**
The official data.gov.sg NEA food establishment licence datasets. Eating establishments include the food hygiene grade; supermarkets are a separate licence dataset.
**What do the grades A, B, C and D mean?**
They are NEA's food hygiene grades for licensed eating establishments, from A (highest) to D (lowest passing standard).
**Does it need a login or API key?**
No. It reads the public open data portal with no account and no key.
**How fresh is it?**
The source datasets are refreshed by the government on a rolling basis.
### Example use cases
Ready-to-run example tasks, each preconfigured for a common scenario. Open one and press run, or use it as a template:
- [Singapore Grade A Food Hygiene Restaurants (NEA)](https://apify.com/scrapers_lat/singapore-food-hygiene-grades-scraper/examples/sg-food-hygiene-grade-a-restaurants): Scrape Singapore NEA eating establishments rated food hygiene grade A. Get licensee, address, demerit points and licence number as JSON, CSV or Excel.
- [Singapore Grade B Food Hygiene Establishments (NEA)](https://apify.com/scrapers_lat/singapore-food-hygiene-grades-scraper/examples/sg-food-hygiene-grade-b-establishments): Scrape Singapore NEA licensed eating establishments with food hygiene grade B. Export licensee name, premises address and licence number to CSV or Excel.
- [Singapore Grade C Food Hygiene Establishments (NEA)](https://apify.com/scrapers_lat/singapore-food-hygiene-grades-scraper/examples/sg-food-hygiene-grade-c-establishments): Scrape Singapore NEA licensed food shops rated hygiene grade C. Get licensee, address, demerit points and suspension dates as JSON, CSV or Excel.
- [Singapore Licensed Supermarkets Directory (NEA)](https://apify.com/scrapers_lat/singapore-food-hygiene-grades-scraper/examples/sg-licensed-supermarkets-nea): Scrape every NEA licensed supermarket in Singapore. Export licensee, building, street, unit and postal code to CSV or Excel. No login or API key.
- [Singapore FairPrice Supermarket Licences (NEA)](https://apify.com/scrapers_lat/singapore-food-hygiene-grades-scraper/examples/sg-fairprice-supermarket-licences): Scrape NTUC FairPrice supermarket licences in Singapore from the NEA register. Get every outlet address, unit and postal code as JSON, CSV or Excel.
- [Singapore McDonald's Grade A Outlets (NEA)](https://apify.com/scrapers_lat/singapore-food-hygiene-grades-scraper/examples/sg-mcdonalds-grade-a-outlets): Scrape McDonald's Singapore outlets rated food hygiene grade A by NEA. Export licence number, premises address and grade to CSV, JSON or Excel.
- [Singapore Orchard Road Food Establishments (NEA)](https://apify.com/scrapers_lat/singapore-food-hygiene-grades-scraper/examples/sg-orchard-road-food-establishments): Scrape licensed food establishments along Orchard Road Singapore with NEA hygiene grades. Get licensee, address and licence number as CSV or Excel.
- [Singapore Tampines Food Establishments (NEA)](https://apify.com/scrapers_lat/singapore-food-hygiene-grades-scraper/examples/sg-tampines-food-establishments): Scrape licensed eating establishments in Tampines Singapore with NEA food hygiene grades. Export licensee, address and grade to JSON, CSV or Excel.
- [Singapore Jurong Food Establishments (NEA)](https://apify.com/scrapers_lat/singapore-food-hygiene-grades-scraper/examples/sg-jurong-food-establishments): Scrape licensed food establishments in Jurong Singapore with NEA hygiene grades. Get licensee name, premises address and licence number as CSV or Excel.
- [Singapore Bedok Food Establishments (NEA)](https://apify.com/scrapers_lat/singapore-food-hygiene-grades-scraper/examples/sg-bedok-food-establishments): Scrape licensed eating establishments in Bedok Singapore with NEA food hygiene grades. Export licensee, address and grade to JSON, CSV or Excel.
### Export, API and AI agents (x402 + MCP)
Export the scraped data to **JSON, CSV or Excel**, pull it as a **dataset** through the Apify **API**, or wire it into your app with **no code**. This web scraper and data extractor also works for bulk data extraction and scheduled runs.
For AI agents: this Actor is available on **x402**, Apify's agentic payment standard built with Coinbase. An AI agent can discover, pay for and run it on its own with a funded wallet and a single HTTP request: no account, no subscription, no API key and no human in the loop. It also runs as an **MCP** tool inside Claude, Cursor and other AI clients out of the box. Learn more about [x402 agentic payments on Apify](https://docs.apify.com/platform/integrations/x402).
### Related scrapers
Need data from the same space? Here are other scrapers we build and maintain:
- [Singapore GeBIZ Government Contracts Scraper](https://apify.com/scrapers_lat/singapore-gebiz-contracts-scraper): Singapore government awarded contracts with agency, supplier and amount.
- [SAM.gov Opportunities Scraper](https://apify.com/scrapers_lat/sam-gov-opportunities-scraper): US federal contract opportunities by agency and NAICS.
- [Google Maps Scraper](https://apify.com/scrapers_lat/google-maps-scraper): Business listings with address, phone and rating.
- [CanadaBuys Tenders Scraper](https://apify.com/scrapers_lat/canadabuys-tenders-scraper): Canadian government tender notices with buyer and category.
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for public platforms across the world: real estate, jobs, e-commerce, company registries and government data. Browse the full catalog, see live sample output for each one, or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with the National Environment Agency (NEA) or the Government of Singapore. It only accesses data published openly on data.gov.sg. Use it in accordance with the portal's terms.
# Actor input Schema
## `licenceType` (type: `string`):
Which NEA dataset to read. "Eating establishments" are licensed food shops (restaurants, hawker stalls, food courts) and carry a food hygiene grade A, B, C or D. "Supermarkets" are licensed supermarket premises (no hygiene grade).
## `grade` (type: `string`):
Keep only eating establishments with this NEA food hygiene grade. A is the best, D is the lowest. Only applies to the eating establishments dataset. Leave empty to include every grade.
## `searchQuery` (type: `string`):
Filter by any keyword across the record: licensee name or premises address (for example "MCDONALD", "ORCHARD ROAD", a mall name). Leave empty to pull the full list newest first.
## `sortByNewest` (type: `boolean`):
Return the most recently added licences first. Turn off to read in the source order.
## `maxItems` (type: `integer`):
Maximum number of licence records to collect. The portal rate-limits anonymous access, so very large pulls are paced automatically.
## Actor input object example
```json
{
"licenceType": "eating",
"grade": "",
"sortByNewest": true,
"maxItems": 1000
}
````
# Actor output Schema
## `results` (type: `string`):
No description
# 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 = {
"searchQuery": "",
"maxItems": 1000
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/singapore-food-hygiene-grades-scraper").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 = {
"searchQuery": "",
"maxItems": 1000,
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/singapore-food-hygiene-grades-scraper").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 '{
"searchQuery": "",
"maxItems": 1000
}' |
apify call scrapers_lat/singapore-food-hygiene-grades-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/singapore-food-hygiene-grades-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Singapore NEA Food Hygiene Grades Scraper",
"description": "Scrape Singapore NEA licensed food shops and their hygiene grade (A/B/C/D) from the official data.gov.sg open data portal. Get licensee name, licence number, address, demerit points and suspension dates. Export to JSON, CSV or Excel.",
"version": "0.1",
"x-build-id": "8P50k5Ee3MQMew5yx"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~singapore-food-hygiene-grades-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-singapore-food-hygiene-grades-scraper",
"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/scrapers_lat~singapore-food-hygiene-grades-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-singapore-food-hygiene-grades-scraper",
"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/scrapers_lat~singapore-food-hygiene-grades-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-singapore-food-hygiene-grades-scraper",
"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": {
"licenceType": {
"title": "Licence type",
"enum": [
"eating",
"supermarket"
],
"type": "string",
"description": "Which NEA dataset to read. \"Eating establishments\" are licensed food shops (restaurants, hawker stalls, food courts) and carry a food hygiene grade A, B, C or D. \"Supermarkets\" are licensed supermarket premises (no hygiene grade).",
"default": "eating"
},
"grade": {
"title": "Food hygiene grade",
"enum": [
"",
"A",
"B",
"C",
"D"
],
"type": "string",
"description": "Keep only eating establishments with this NEA food hygiene grade. A is the best, D is the lowest. Only applies to the eating establishments dataset. Leave empty to include every grade.",
"default": ""
},
"searchQuery": {
"title": "Search keyword",
"type": "string",
"description": "Filter by any keyword across the record: licensee name or premises address (for example \"MCDONALD\", \"ORCHARD ROAD\", a mall name). Leave empty to pull the full list newest first."
},
"sortByNewest": {
"title": "Newest first",
"type": "boolean",
"description": "Return the most recently added licences first. Turn off to read in the source order.",
"default": true
},
"maxItems": {
"title": "Max items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of licence records to collect. The portal rate-limits anonymous access, so very large pulls are paced automatically."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```