TravelType API

Auf einen Blick

• Basis-URLhttps://traveltype.app
• Authentifizierungkeine
• FormatJSON, UTF-8, CORS *
• Rate-Limit60 Anfragen/Min pro IP
• Sprache?lang=en|de (EN ist kanonisch, Fallback en→de)

Schnellstart

curl 'https://traveltype.app/api/public/pois/search?q=rooftop&city=berlin&limit=3'

Endpunkte

• GET/api/public/pois/search
  Orte suchen (Prefix/Tag/Fuzzy-Ranking + Beliebtheits-/Geo-Boost)Parameter: q (≥2) or city, tags, limit (≤50), lang
• GET/api/public/pois/{id}
  Ort im Detail (per UUID oder Slug)Parameter: id, lang
• GET/api/public/pois/{id}/similar
  Ähnliche Orte (Tag-Cosine)Parameter: id, limit (≤30), lang
• GET/api/public/cities
  Städte-Liste, nach POI-Anzahl sortiertParameter: country, limit (≤100), offset
• GET/api/public/cities/{slug}
  Stadt im Detail (Top-Tags + Beispiel-Orte)Parameter: slug, lang
• GET/api/public/countries
  Länder-Liste (mit Stadt-/Ort-Anzahl)
• GET/api/public/countries/{iso2}
  Land im Detail (Städte, Top 100)Parameter: iso2

Maschinenlesbare Spezifikation: /openapi.json (OpenAPI 3.1)

Antwort-Beispiel

{
  "pois": [
    {
      "id": "6f1c0b2e-…",
      "slug": "brandenburger-tor",
      "name": "Brandenburg Gate",
      "lat": 52.5163, "lng": 13.3777,
      "city_slug": "berlin", "country_iso2": "DE",
      "tags": ["landmark", "architecture", "neoclassical"],
      "wikidata_qid": "Q82425",
      "image_url": "https://traveltype.app/poi-images/…jpg",
      "url": "https://traveltype.app/poi/brandenburger-tor"
    }
  ],
  "count": 1
}

Fehler

Fehler kommen als JSON mit { error, message, trace_id } und passendem Statuscode — bei Validierung (422) stattdessen { error, issues, trace_id }:

• 404Ressource nicht gefunden
• 422Ungültige Parameter
• 429Rate-Limit überschritten
• 500Interner Fehler