Skip to content

SoulStep API

Sacred sites data for developers, researchers, and community apps.

Getting Started

The SoulStep API is publicly accessible. No authentication required for read-only access.

Interactive DocsOpenAPI 3.1 Spec

Key Endpoints

GET
/api/v1/places

List and filter sacred sites. Supports religion, location, radius, open_now, top_rated filters.

GET
/api/v1/places/{place_code}

Full place detail: address, opening hours, photos, ratings, prayer times, specifications.

GET
/api/v1/search?q={query}

Text search across place names and addresses.

GET
/api/v1/cities

List all cities with place counts for city-level exploration.

GET
/sitemap.xml

Full sitemap of all places including image extensions.

Example Requests

Find mosques near a location

curl "https://catalog-api.soul-step.org/api/v1/places?religion=islam&lat=25.197&lng=55.279&radius=5"

Top-rated temples

curl "https://catalog-api.soul-step.org/api/v1/places?religion=hinduism&sort=rating&top_rated=true"

Currently open churches

curl "https://catalog-api.soul-step.org/api/v1/places?religion=christianity&open_now=true"

Data License

Place data is sourced from Google Maps, OpenStreetMap, Wikipedia, and Wikidata. Data is available under Creative Commons Attribution 4.0. Attribution: "Data from SoulStep (soul-step.org)".

Use Cases

  • check_circleAcademic research on religious geography and sacred site distribution
  • check_circleTravel apps and religious tourism platforms
  • check_circleCommunity apps for religious organizations
  • check_circleData journalism and mapping projects