Beautiful Places API
Welcome to the Beautiful Places API Developer Portal.
Discover scenic points of interest (POIs) across the UK, including landmarks, parks, historic buildings, and natural beauty spots. Our API provides access to curated location data with scenic ratings to help you find the most beautiful places.
This portal provides clear, accessible documentation for integrating with the Beautiful Places API.
We are partnering with a small number of providers to shape our API services. Free access is guaranteed until 31st December 2026, after which the API will transition to a fully paid service. Access is limited to 4 partners, with all rate limits shared to ensure service quality. If you require exclusive access with dedicated rate limits before this date, please contact us at [email protected] about our paid plans.
By using this API, you agree to our Terms of Use.
Getting Started
-
Sign In
Click the Sign In button in the top right to create an account or sign in with Google.
-
Explore the API Reference
The API Reference contains all available endpoints. Visit the demo page to preview how the API calls work.
-
Get Your API Key
Once signed in, visit Settings > API Keys to view your API key. Use this key in the
Authorizationheader for all API requests. -
Start Building
Use the API to find nearby scenic places, filter by scenic quality, or search by UK area codes. When integrating the API, you must:
-
Add attribution: Include a visible link in your application with the text "See more scenic places on the Beautiful Places app" (or similar text agreed with us), linking to
https://www.beautifulplaces.ai/?ref=YOUR_REFERRAL_CODE. Your referral code will be provided when you receive API access. -
Display image credits: Some images include a
creditsfield. When displaying these images, show the attribution exactly as provided (e.g. "© Martin Addison (cc-by-sa/2.0)"). Images without acreditsfield do not require attribution.
See our Terms of Use for full requirements.
-
API Endpoints
| Endpoint | Description |
|---|---|
GET /scenic-nearby/{filter} | Returns 3 nearest scenic POIs to a location |
GET /scenic-by-area/{type}/{area_code} | Returns scenic POIs within a UK area |
Rate Limits
All limits are shared across users.
| Limit | Value |
|---|---|
| Monthly Quota | 1,000,000 requests per month |
| Daily Quota | 250,000 requests per day |
| Rate Limit | 1,000 requests per second |
| Burst Limit | 5,000 requests |
Exceeding limits will result in HTTP 429 responses.
Need Help?
- Browse the API Reference for detailed endpoint documentation
- Visit the demo page to preview API calls