API recipes

Worked examples that combine multiple endpoints to build common features. Use these as starting points for your integration.

Available recipes

• Replicate the Summary plugin from raw API calls — rebuild what the JS Summary plugin renders, but with your own HTML, fonts, and layout.
• Build a custom map UI — combine /points and /categories with your favourite map library (Leaflet, MapLibre, Mapbox GL).
• Bulk POI scoring for a property catalog — score thousands of listings nightly and store the results in your own database for filtering.

Patterns shared by every recipe

• Read Authentication first. All recipes assume you have a working key.
• Pick the right country subdomain for the data you’re querying. Brussels data lives on be.yatmo.com, not fr.yatmo.com.
• Cache aggressively on your side — Yatmo’s output is stable for days. Re-fetching the same coordinate every request wastes both ends’ CPU.
• Surface errors clearly. The Errors page lists the patterns you should handle (especially 429 and 4xx).