API Endpoints

Community and Leisure

Shopping Centres

Tokens
× 1

API Credit Cost


Endpoint Overview

The Shopping Centres endpoint lists major shopping destinations within a postcode radius, including their names, sizes, and types of stores available.


Coverage

EnglandEngland
ScotlandScotland
WalesWales
N. IrelandN. Ireland

Update Frequency

Annually

Request Format

HTTP Method:

GET

To 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/shopping-centres/?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/shopping-centres/?key={api_key}&postcode=WS3+3PD

For example:

https://api.postcodearea.co.uk/shopping-centres/?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/shopping-centres/?key=&postcode=WS3+3PD
{"data":[{"Name":"Gaolgate Place Shopping Centre","Town":"Stafford","Postcode":"ST162AD","Phone":"","Website":" ","Units":"","Car Parking Spaces":"","Anchor Tenants":"","Other Tenants":"","Description":"The Gaolgate Place Shopping Centre in Stafford offers a diverse range of facilities including various retail stores, dining options, and essential services, making it a convenient destination for shoppers. Major tenants include popular brands and supermarkets. The centre attracts a significant number of visitors annually, thanks to its accessible location and comprehensive amenities. Ample car parking is available, ensuring a hassle-free shopping experience. For more information, please visit the official Gaolgate Place website.","Latitude":"52.8088569641113","Longitude":"-2.11923098564148","Distance":5.56902550301001},{"Name":"Guildhall Shopping Centre","Town":"Stafford","Postcode":"ST16 2BB","Phone":"","Website":"http://www.guildhallstafford.com/","Units":"","Car Parking Spaces":"","Anchor Tenants":"","Other Tenants":"","Description":"The Guildhall Shopping Centre in Stafford offers a diverse range of facilities and major tenants like Boots, Bodycare, and Sports Direct. With its convenient central location, it attracts a substantial number of visitors annually. Ample car parking is available nearby, ensuring ease of access for shoppers. The centre boasts a mix of retail, dining, and services, making it a popular shopping destination. For further information, visit the official website at Guildhall Shopping Centre.","Latitude":"52.8071327209473","Longitude":"-2.11817288398743","Distance":5.58126084511229},{"Name":"Cannock Shopping Centre","Town":"Cannock","Postcode":"WS111WS","Phone":"","Website":"http://www.cannock-shopping.co.uk/","Units":"","Car Parking Spaces":"","Anchor Tenants":"","Other Tenants":"","Description":"Cannock Shopping Centre, located in the heart of Cannock, offers a variety of retail and dining options for visitors. Major tenants include popular stores like JD Sports and Boots. The centre provides ample car parking facilities with dedicated spaces for disabled visitors and families. With an estimated 200,000 monthly visitors, the centre is a bustling retail hub. Explore more about its offerings, events, and promotions through their official site.Read more about Cannock Shopping Centre","Latitude":"52.6902694702148","Longitude":"-2.03050899505615","Distance":11.296376531576},{"Name":"Telford Shopping Centre ","Town":"Telford ","Postcode":"TF34BX","Phone":"01952 230032","Website":"http://www.telfordshopping.co.uk/","Units":" ","Car Parking Spaces":" ","Anchor Tenants":" ","Other Tenants":" ","Description":"Telford Shopping Centre has everything to create your ideal shopping experience.  Offering a wide choice from high street to designer brands across 166 stores, there is something for everyone.   From High Street fashion including HOUSE OF FRASER, DEBENHAMS and M&S to enticing eateries, it's the perfect way to indulge and enjoy.The centre is located off Junction 5 on the M54. Clear road signage is provided on approach to Telford Shopping Centre from all directions. Telford has seven car parks from short stay to long stay to make your shopping trip easier.  All car parks are nearby and are all winners of the Park Mark safe parking award. Opening Hours:Mon-Wed, Fri-Sat9.00am - 6.00pmThursday9.00am - 8.00pmSunday10.30am - 4.30pmBank Holiday10.00am - 5.00pm","Latitude":"52.6766204833984","Longitude":"-2.4467830657959","Distance":11.3146509079885},{"Name":"Madeley District Centre","Town":"Telford","Postcode":"TF7 5EB","Phone":"","Website":" ","Units":"","Car Parking Spaces":"","Anchor Tenants":"","Other Tenants":"","Description":"Madeley District Centre in Telford is a bustling community hub offering an array of facilities including supermarkets, local shops, and eateries. Major tenants include Tesco and Lloyds Pharmacy, catering to daily needs. The centre is easily accessible with ample car parking spaces. It attracts a significant number of visitors, ensuring a lively atmosphere. For more information on facilities and events, visit the official website.","Latitude":"52.6372413635254","Longitude":"-2.44975090026855","Distance":13.3879451470511}],"response_time":0.0156,"Source":"PostcodeArea API","Output Area":"Radius","Radius":10,"Distance Unit":"Mile","Records":5,"Unique Fields":14.6,"Referrer":"api.postcodearea.co.uk","Host":"https://api.postcodearea.co.uk/shopping-centres/?key=pa_XWQAV24RXCUU19NGUFM11TKTLN&postcode=st200ly","Endpoint":"/shopping-centres/?key=pa_XWQAV24RXCUU19NGUFM11TKTLN&postcode=st200ly"}

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:

  1. Stored in-memory only (e.g., application-level cache).
  2. 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.

Share this page