- Census Demographics
- Demography
- Age by 5 year Age Bands
- Household Composition
- Household Size
- Households by Deprivation Dimensions
- Legal Partnership Status
- Length of Residence
- Number of Households
- Number of Residents
- Population Density
- Sex
- Sex by Single Year of Age
- Social Grades
- Education
- Highest Level of Qualification
- Schoolchildren and Full Time Students
- Ethnicity & Religion
- Age of Arrival in UK
- Country of Birth
- Country of Birth Detailed
- Ethnic Group
- Household Language
- Migrant Indicator
- Multiple Ethnic Group
- National Identity
- Number of Non-UK short-term Residents by Sex
- Passports Held
- Passports Held
- Proficiency in English
- Religion
- Year of Arrival in UK
- Health
- Disability
- General Health
- Provision of Unpaid Care
- Housing
- Accommodation Type
- Car Van Availability
- Central Heating
- Number of Bedrooms
- Number of Rooms
- Occupancy Rating for Bedrooms
- Occupancy Rating for Rooms
- Purpose of 2nd Address
- Second Address Indicator
- Tenure
- Work & Travel
- Distance Travelled to Work
- Economic Activity Status
- Hours Worked
- Method of Travel
- NS-SeC
- Occupation
- Unemployment History
- Community and Leisure
- Constituency and Legal
- Crime & Policing
- Dining and Shopping
- Economic Indicators
- Education and Childcare
- Geographic & Environment
- Health and Wellbeing
- Housing and Property
- Public Services & Amenities
- Transport and Mobility
- Utilities and Infrastructure
Search API
Dining and Shopping
Supermarkets
× 1
API Credit Cost
Endpoint Overview
The Supermarkets endpoint provides a list of grocery stores within a postcode radius, including store names, locations, and major chains.
Coverage
England
Scotland
Wales
N. IrelandUpdate Frequency
Bi-Annually
Request Format
HTTP Method:
GETTo use the API you should send an HTTP request to the following endpoint URL. This will return a JSON response.
https://api.postcodearea.co.uk/supermarkets/?key=&postcode={postcode}
Note that your key has automatically been added to the API endpoint for convenience.
Querystring Parameters:
{postcode}
A valid UK postcode (e.g., SW1A 1AA). Note that you can send the postcode with or without the space separating the outward and inward codes. For example, both "SW1A 1AA" and "SW1A1AA" are both valid.
{api_key}
A valid API key that authenticates your account.
Authorisation
For every endpoint request your API Key should be sent as part of the querystring:
https://api.postcodearea.co.uk/supermarkets/?key={api_key}&postcode=WS3+3PD
For example:
https://api.postcodearea.co.uk/supermarkets/?key=&postcode=WS3+3PD
Example Request and Response
If the above URL endpoint exists and the API key is valid, our system will return the following example response:
https://api.postcodearea.co.uk/supermarkets/?key=&postcode=WS3+3PD
Error Handling
| HTTP Status Code | Error Message | Reason |
|---|---|---|
| 400 | Invalid postcode format | The postcode provided is not valid. |
| 401 | Unauthorised request | API key missing or invalid. |
| 404 | Postcode not found | No data available for the given postcode. |
| 404 | No Results Found | No data available for the given radius. |
| 429 | Too many requests | Exceeded rate limit. |
| 500 | Internal server error | An unexpected issue occurred. |
Caching Policy
You may temporarily cache data retrieved from the API for performance optimisation purposes, provided that the cached data is:
- Stored in-memory only (e.g., application-level cache).
- Retained for no longer than one hour.
Caching API data to any persistent storage, including but not limited to databases, files, or external systems, constitutes a breach of our API Terms and Conditions. Such actions are strictly prohibited to ensure data accuracy and compliance with our licensing agreements.
If you have specific requirements for extended caching, you must seek prior written consent from us.
Get started today
Ready to use this data for your own business or organisation? Sign up today and get immediate access to all the PostcodeArea API endpoints.