# ShutterAtlas: wildlife photo hides and lodges

> Find wildlife photography hides, lodges, tours and workshops on a 3D globe, see whether each sits inside or outside a national park or private conservancy, and see which species are in season, by month, with odds, peak weeks and sources.

Everything the site shows is available as read only JSON. No key is needed (phase 1). Field names are camelCase, query parameters snake_case, lists comma separated. Errors are {"error": {"code", "message"}}.

## API

- [OpenAPI 3.1 document](https://shutteratlas.com/api/v1/openapi.json): every endpoint and schema
- [Search](https://shutteratlas.com/api/v1/search?q=lynx): species (any name, synonyms, scientific), places (with bbox) and listings; "national parks in Finland" answers with that country's national parks and an intent
- [Species](https://shutteratlas.com/api/v1/species): list or search; /api/v1/species/{slug} has the window grid (places by month, odds, peak weeks) and listings
- [Places](https://shutteratlas.com/api/v1/places/europe/finland): continent, country or park with windows by month, species and listings; sort=rank|price_asc|price_desc|distance|odds
- [Windows](https://shutteratlas.com/api/v1/windows?months=6): shooting windows for months, species or a bbox, each with a trust line (confidence, last verified, sources)
- [Listings](https://shutteratlas.com/api/v1/listings?species=brown-bear&months=6): hides, lodges and tours with inside/outside park badge, price from, months; park=national, place, and price_min/price_max with price_currency (converted at ECB rates) and unpriced=include; lens_mm (longest lens, full-frame mm) with lens_unknown=include; /api/v1/listings/{id} for one
- [National parks](https://shutteratlas.com/api/v1/national-parks?country=europe/finland): a country's national parks with listing counts; without country, every country that has them
- [In season](https://shutteratlas.com/api/v1/in-season?country=FI): what is in season in a country this month

## Pages

- [Globe](https://shutteratlas.com/): the landing page; URL parameters q, species, months, types, park, price_min, price_max, price_currency, on_request, lens, lens_unknown, view, sel, c
- [Search](https://shutteratlas.com/search?q=lynx): list-first search without the globe (server rendered, works without JavaScript); URL parameters q, species, months, types, park, price_min, price_max, price_currency, on_request, lens, lens_unknown, sort
- [National parks](https://shutteratlas.com/national-parks): national parks by country, e.g. https://shutteratlas.com/national-parks/europe/finland
- List pages by place, e.g. [Europe](https://shutteratlas.com/europe), [Finland](https://shutteratlas.com/europe/finland), [Oulanka National Park](https://shutteratlas.com/europe/finland/oulanka)
- [Shoot windows](https://shutteratlas.com/windows): every shooting window, this month first, grouped by species; URL parameter months
- [Species](https://shutteratlas.com/species): every species by group; URL parameters q, group. Species pages, e.g. https://shutteratlas.com/species/brown-bear
- Listing pages: https://shutteratlas.com/listing/{public id}-{slug}
- [About the data](https://shutteratlas.com/about/data): sources and credits
- [Sitemap](https://shutteratlas.com/sitemap.xml)

## Notes

- URLs and public ids are stable.
- API prices are in the operator's currency. /api/v1/rates serves ECB reference rates for an approximate conversion; a price filter with price_currency is converted with the same rates on the server.
- Window verdicts and creative notes may be withheld; when they are, "open" flags still say which months a window covers.