Pilgrimap API

Veröffentlichte Wallfahrtsorte als JSON, GeoJSON oder CSV auslesen und ohne API-Schlüssel konfigurierbare, barrierearme iFrames erstellen.

Developer API

Versionierte, öffentliche Lese-API für Orte, Kategorien, Länder, Regionen, Lexikon, Bilder, Exporte und Einbettungen.

Bitte die sichtbare Pilgrimap-Quellenangabe beibehalten.

Antwort-Header:

X-Pilgrimap-Attribution: Pilgrimap by Eble ITLink: <https://pilgrimap.org/de/api-docs>; rel="describedby"GET https://pilgrimap.org/api/v1/meta

JSON · GeoJSON · CSV · iFrame

Text, Kategorie, Land, Region, Ort, Kartenausschnitt, Radius, Kontaktdaten und Änderungsdatum lassen sich kombinieren. Mehrere Werte werden durch Kommas getrennt.

/api/v1/export?format=geojson&country=DE&category=marienheiligtum

Endpunkte

GET Orte /api/v1/places

q, category, country, region, locality, bbox, lat, lng, radius_km, fields, page, per_page

GET Orte /api/v1/places/<slug>

Complete localized place record

GET Mehrfachabruf /api/v1/places/batch?slugs=…

Up to 100 stable slugs in the requested order

GET Suchergebnisse /api/v1/search?q=…

Place names, alternative names and localities; categories are not returned as suggestions

GET Kategorien /api/v1/categories

Kategorien mit Symbolen, Farben und Zählwerten

GET Category detail /api/v1/categories/<slug>

Kategorie mit Beschreibung und direkter Orts-Collection

GET Länder /api/v1/countries

Länderliste mit veröffentlichten Ortszahlen

GET Country detail /api/v1/countries/<code>

Landprofil mit Beschreibung und Orts-Collection

GET Regionen /api/v1/regions?country=DE

Regionen und direkte Filterlinks

GET Region detail /api/v1/regions/<code>/<region>

Regionsprofil mit Beschreibung und Orts-Collection

GET Facetten /api/v1/facets

Category and country counts for interfaces

GET Im Umkreis /api/v1/nearby?lat=…&lng=…

Radius search with exact distance_km

GET Bilder /api/v1/places/<slug>/images

Bild-URLs, Thumbnails, Abmessungen und MIME-Typen

GET Single image /api/v1/images/<id>

Metadaten eines einzelnen veröffentlichten Ortsbildes

GET Lexicon /api/v1/lexicon

Alphabetisch durchsuchbare Lexikonartikel

GET Lexicon article /api/v1/lexicon/<slug>

Vollständiger Lexikonartikel als strukturierte Daten

GET Embeds /api/v1/embeds

Discovery-Endpunkt für verfügbare iFrame-Oberflächen

GET Ähnliche Orte /api/v1/places/<slug>/related

Category, region and distance based suggestions

GET GeoJSON /api/v1/geojson

All filters supported; FeatureCollection

GET Export /api/v1/export?format=json|geojson|csv

Filtered export with up to 10,000 records

GET Kartenanbieter /api/v1/map-providers

Licensed Eble IT MapLibre style contract

GET OpenAPI /api/v1/openapi.json

OpenAPI 3.1 machine-readable contract

Filter

Text, Kategorie, Land, Region, Ort, Kartenausschnitt, Radius, Kontaktdaten und Änderungsdatum lassen sich kombinieren. Mehrere Werte werden durch Kommas getrennt.

Parameter	Values	Purpose
`q`	text	Name, alternative name, locality, region, postal code
`category`, `categories`	comma-separated slugs	One or many categories; `exclude_category` excludes values
`country`, `countries`	ISO 3166-1 alpha-2	One or many countries
`region`, `locality`	one or many values	Geographic text filters
`bbox`	west,south,east,north	Map viewport, including antimeridian boxes
`lat`, `lng`, `radius_km`	coordinates + 1–1000 km	Geographic radius filter
`featured`, `has_images`, `has_website`, `has_phone`, `has_email`	true / false	Availability filters
`updated_since`	ISO-8601	Incremental synchronization
`fields`	comma-separated field names	Sparse fieldsets; id and slug remain present
`sort`, `order`	name/locality/updated · asc/desc	Stable ordering

iFrame-Konfigurator

Inhalt, Kartenanbieter, Farbstil, Akzentfarbe, Rundung, Kopfbereich und Quellenangabe konfigurieren. Die erzeugte URL aktualisiert sich sofort.

Vorschau

Einbettungscode

JavaScript

const response = await fetch('https://pilgrimap.org/api/v1/places?country=DE&category=marienheiligtum&fields=id,slug,name,latitude,longitude');
const { data, pagination } = await response.json();

Python

import requests

response = requests.get(
    'https://pilgrimap.org/api/v1/export',
    params={'format': 'geojson', 'bbox': '8.0,47.0,14.0,51.0'},
    timeout=10,
)
response.raise_for_status()

Die offene Leseschnittstelle macht veröffentlichte Orts- und Kategoriedaten maschinenlesbar. Sie eignet sich für eigene Karten, kirchliche Informationsangebote, Forschung und nichtkommerzielle Projekte. Schreibzugriffe, Benutzerkonten und interne Verwaltungsdaten sind nicht Bestandteil der API.