Blueground Properties API

Everything you need to access Blueground properties for distribution — authentication, listings, and availability in one place.

Before you begin — You'll need a client_id and client_secret issued by Blueground.

How it works

Authenticate

Use your client_id and client_secret to obtain a Bearer token. Include it in the Authorization header of every request.

Fetch your properties

Invoke the Properties Details endpoint to retrieve your full property catalogue — address, amenities, pricing, media, and policies. Use cursor-based pagination to iterate through all pages and collect the property IDs.

Check availability

Pass up to 100 property IDs to the Properties Calendar endpoint to get daily availability, pricing, and booking restrictions for each property.

Authentication

Learn how to authenticate your requests to the Blueground Properties API using OAuth bearer tokens.

Properties Details

Retrieve detailed property information including address, amenities, pricing, and policies.

Properties Calendar

Retrieve availability calendar data with daily pricing and booking restrictions.

Download API Collection

Best Practices

Fetch the full property list at most once per hour. More frequent full syncs are unnecessary as listing data does not change that often, and may result in throttled requests.
When paginating through the full catalogue, aim to complete all pages within 30 minutes to ensure data consistency across the entire sync.

Rate Limiting

All endpoints are rate-limited to 150 requests per 10 seconds per IP address. Requests that exceed this limit will receive a 429 Too Many Requests response.