# Alberta Travel - Agent Access Layer

This site provides an agent-friendly API layer for structured travel data in Alberta, Banff, Jasper, and the Canadian Rockies.

## Canonical agent docs

- Agent docs (human + model readable): https://www.albertatravel.net/agent
- OpenAPI spec: https://www.albertatravel.net/openapi-agent.json
- AI plugin manifest: https://www.albertatravel.net/.well-known/ai-plugin.json

## Base API

- Base URL: https://www.albertatravel.net
- Primary namespace: /api/agent
- Response format: application/json
- CORS: enabled for GET/POST/OPTIONS

## Recommended API flow

1. Check API health:
   - GET /api/agent/health
2. Pull full context bundle in one call:
   - GET /api/agent/context?lang=zh
3. Or query by resource:
   - GET /api/agent/destinations
   - GET /api/agent/itineraries
   - GET /api/agent/guides
   - GET /api/agent/practical
4. Semantic-lite retrieval:
   - GET /api/agent/search?q=banff%20winter
5. Submit lead/inquiry:
   - POST /api/contact

## Query parameters

- lang: zh | en
- season: spring | summer | fall | winter
- days: integer
- style: free text token (e.g. self-drive, family, photography)
- budget: mid | mid_high | high
- topic: weather | transportation | budget | accommodation
- q: free text search

## Data coverage

- Destinations: Banff, Jasper, Icefields Parkway, Lake Louise, Calgary
- Itineraries: 3-day Banff, 5-day Rockies, 7-day Alberta
- Guides: self-drive, family, wildlife, photography, summer hiking, winter skiing
- Practical playbooks: weather, transportation, budget, accommodation

## Contact

- Email: hello@albertatravel.net
- Website: https://www.albertatravel.net