API

If you are a web developer, you can access Ratemyplace data programatically in a variety of ways, allowing you to plug Ratemyplace data into your own website.

API Documentation

Search

This returns basic information about all premises that fit the search criteria, including the name of the premises, link to the premises page, the town or village the premises is in, the local authority and the rating.

Formats available are .json or .xml

Example

http://www.ratemyplace.org.uk/inspections/search.json?name=mcdonalds&category=Restaurant/Cafe/Canteen&council=3&town=cannock&rating=5

View example

Arguments

Argument Description
name The name (or part of the name) of the business (or businesses) you are looking for
category The category of the business (or businesses) you are looking for. One of the following:
  • Primary Producers
  • Manufacturers and Packers
  • Importers/Exporters
  • Distributors/Transporters
  • Supermarket/Hypermarket
  • Small retailer
  • Retailer - other
  • Restaurant/Cafe/Canteen
  • Hotel/Guest house
  • Pub/Club
  • Take-away
  • Caring premises
  • School/College
  • Mobile food unit
council The ID of the council that has inspected the business (or businesses) you are looking for. One of the following:
  • 1 = Lichfield District Council
  • 2 = Stafford Borough Council
  • 3 = Cannock Chase District Council
  • 4 = East Staffordshire Borough Council
  • 5 = South Staffordshire Council
  • 6 = Tamworth Borough Council
  • 7 = Staffordshire Moorlands District Council
  • 8 = High Peak Borough Council
  • 290 = Newcastle Under Lyme Borough Council
  • 880 = Stoke-on-Trent City Council
town The town or village (or part of) that the business (or businesses) you are looking for is in
rating The rating that the business (or businesses) you are looking for has been awarded (between 1 and 5)
distance If lat and lng are defined, returns premises that meet all of the above criteria within a distance of x miles
lat For use in conjunction with distance and lng , the latitude of the point you are searching from
lng For use in conjunction with distance and lat , the longitude of the point you are searching from

View

Simply add .xml or .json to the url of any inspection to get the raw data for that inspection

Example

http://www.ratemyplace.org.uk/inspections/mcdonalds-cannock.json

View example

Bulk download

Download all inspections for a particular council (or all councils) in XML, JSON or CSV format:

Licence

This data is published under the Open Government Licence