# PhotoMap.World: 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://photomap.world/api/v1/openapi.json): every endpoint and schema
- [Search](https://photomap.world/api/v1/search?q=lynx): species (any name, synonyms, scientific), places (with bbox) and listings
- [Species](https://photomap.world/api/v1/species): list or search; /api/v1/species/{slug} has the window grid (places by month, odds, peak weeks) and listings
- [Places](https://photomap.world/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://photomap.world/api/v1/windows?months=6): shooting windows for months, species or a bbox, each with a trust line (confidence, last verified, sources)
- [Listings](https://photomap.world/api/v1/listings?species=brown-bear&months=6): hides, lodges and tours with inside/outside park badge, price from, months; /api/v1/listings/{id} for one
- [In season](https://photomap.world/api/v1/in-season?country=FI): what is in season in a country this month

## Pages

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

## Notes

- URLs and public ids are stable.
- Prices are in the operator's currency; there is no conversion yet.
- Window verdicts and creative notes may be withheld; when they are, "open" flags still say which months a window covers.