# TravelType

> Community-rated travel points of interest across cities worldwide, with
> editorial descriptions, tags, geo coordinates, and external entity IDs.

## Detail pages
- /poi/[slug] — TouristAttraction with ratings, tags, geo coordinates, Wikidata QID
- /cities/[slug] — City containing multiple POIs with stats + match scores
- /countries/[code] — Country containing cities, ISO 3166-1 alpha-2 code

## Discovery surfaces
- /search — full-text search across cities, POIs, and lists
- /cities — index of covered cities, sortable by POI count
- /countries — index of covered countries with flags + POI totals
- /feed — personalised recommendations for signed-in users; top-rated curation for anonymous

## Open data
- /data — Open Data landing page: free CC-BY 4.0 JSON read-API, sample code, citation
- Dataset JSON-LD on /data is registered for Google Dataset Search

## Programmatic API (for agents)
- /openapi.json — OpenAPI 3.1 spec for the public read API (no auth, CORS-open)
- /api/public/cities — list cities (filter by country, paginated)
- /api/public/cities/[slug] — city detail with top tags + sample POIs
- /api/public/countries , /api/public/countries/[iso2] — country index + detail
- /api/public/pois/search?q=... — ranked POI search (also by city + tags)
- /api/public/pois/[id] — POI detail by UUID or slug
- /api/public/pois/[id]/similar — tag-cosine "more like this"

## Data provenance
- Wikidata QIDs for canonical entity identity (poi.wikidataQid → wikidata.org/wiki/Qxxx)
- Wikimedia Commons for hero images, with attribution + license metadata
- OpenStreetMap for POI candidates and geo coordinates
- TravelType community for ratings (native 0/1/2 scale; schema.org-mapped to 1-5)

## Locale
URLs are locale-agnostic since 2026-05-20. The same path serves DE + EN; the
rendering locale is resolved per request from user preference, cookie, and
Accept-Language. No /de/ or /en/ URL prefix exists.

## Sitemap
https://traveltype.app/sitemap.xml

## About + legal
- https://traveltype.app/about — story, stats, contact
- https://traveltype.app/legal/imprint — operator (KonzeptCode UG)
- https://traveltype.app/legal/privacy — privacy policy
- https://traveltype.app/legal/terms — terms of service