Build with CityGetaway API
Access our AI-powered travel platform with a simple, well-documented REST API. Create custom integrations and build amazing Montreal travel experiences.
curl -X POST https://api.citygetaway.com/v1/itinerary \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"destination": "Montreal",
"days": 5,
"preferences": { "food": 9 }
}'Fast & Reliable
99.9% uptime with average response times under 200ms
Secure
Enterprise-grade security with OAuth 2.0 and API key authentication
Global CDN
Low latency worldwide with our distributed infrastructure
Well Documented
Comprehensive docs with code examples in multiple languages
Quick Start
Get up and running with the CityGetaway API in minutes
Get API Key
Sign up and generate your API key from the dashboard
Make Request
Include your API key in the Authorization header
Build
Start building amazing travel experiences
Authentication
All API requests require authentication using an API key. Include your key in the Authorization header:
Authorization: Bearer YOUR_API_KEYAPI Endpoints
Explore our core API endpoints with example requests and responses
/api/v1/itinerary/generateGenerate an AI-powered Montreal itinerary based on preferences
Request Body
{
"destination": "Montreal",
"days": 5,
"startDate": "2025-06-15",
"budget": 2500,
"travelers": 2,
"preferences": {
"culture": 8,
"food": 9,
"nature": 6,
"nightlife": 5
}
}Response
{
"success": true,
"itinerary": {
"id": "itin_abc123",
"destination": "Montreal",
"days": [...],
"totalCost": 2450,
"createdAt": "2025-01-15T10:30:00Z"
}
}/api/v1/attractions?city=montreal&limit=10Retrieve a list of attractions in Montreal
Response
{
"success": true,
"attractions": [
{
"id": "attr_123",
"name": "Notre-Dame Basilica",
"category": "Historical",
"rating": 4.7,
"coordinates": {...}
},
...
]
}/api/v1/bookingsBook an activity or experience
Request Body
{
"activityId": "act_456",
"date": "2025-06-16",
"travelers": 2,
"timeSlot": "10:00"
}Response
{
"success": true,
"booking": {
"id": "book_789",
"confirmationCode": "MTL-ABC123",
"status": "confirmed",
"totalPrice": 120.00
}
}Rate Limits
Fair usage limits to ensure quality service for all users
| Plan | Requests/Hour | Requests/Day |
|---|---|---|
| Free | 100 | 1,000 |
| Pro | 1,000 | 10,000 |
| Enterprise | Unlimited | Unlimited |
Ready to Start Building?
Get your API key and start integrating CityGetaway into your application today
