Destination search API

Read-only access to the same climate and destination dataset used by the site. No account or API key is required.

Search and share

GET /api/destinations?months=10&weather=warm&lang=en
GET /search?months=10&weather=warm&lang=en
GET /api/destinations?mode=domestic&country=IT&months=9
GET /search?months=10&selected=TR,GR,IT&lang=en

Use calendar months 1–12. Weather tags are hot, warm, cool, beach, dry; multiple tags use OR across the selected months. The JSON response includes a search_url and guide links. The HTML search page renders results without JavaScript. Normal results use a stable dataset order; selected preserves up to three chosen destination codes in order. Saved selections are not re-filtered and do not imply current eligibility.

Filters and validation

Use months or start/end (YYYY-MM-DD, at most 366 days). mode is world, domestic or lucky. Domestic search requires a supported country. visa=no_visa requires passport. flight is an estimated maximum duration in hours and requires origin or passport. limit is 1–100. Unknown parameters, duplicate parameters and invalid values return HTTP 400. Only GET and HEAD are accepted.

Limits of the data

Climate figures are rough estimates at reference locations, not forecasts or verified climate normals. Visa data is an unverified legacy estimate; use official sources for passport-specific entry requirements. Flight duration is distance-based, not a scheduled flight. There are no live prices or booking operations. Search URLs and API responses are noindex; curated editorial pages are indexed.