Caterelo API — Relocation Intelligence for Southern Europe

Quick Start

curl https://caterelo.com/api/lifetrend?region=es-ct

{
  "region": "es-ct",
  "name": "Cataluña",
  "country": "ES",
  "countryName": "Spain",
  "lifeTrend": 74,
  "level": "good",
  "tier": "free"
}

No API key required for basic access. Pro tier unlocks full breakdowns + higher rate limits.

Endpoints

GET/api/lifetrend?region={id}

Get LifeTrend score for a single region. Pro tier includes full 7-dimension breakdown.

Param	Type	Description
`region`	string	Region ID (e.g. `es-ct`, `it-tos`, `pt-alg`)

GET/api/lifetrend?country={CC}

Get all regions in a country ranked by LifeTrend score.

Param	Type	Description
`country`	string	Country code: `ES`, `IT`, `PT`, `GR`, `FR`, `HR`

GET/api/lifetrend?top={N}

Top N regions across all 6 countries. Free: max 5. Pro: max 90.

Param	Type	Description
`top`	number	Number of regions (1-90)

POST/api/advisor

AI Relocation Advisor — ask any question about relocating to Southern Europe. Powered by GPT-4o-mini + Caterelo dataset.

Field	Type	Description
`message`	string	Your question (max 2000 chars)
`history`	array	Previous messages `[{role, content}]` for context (max 6)

// Example request
fetch('/api/advisor', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    message: "Best region for a family with kids under 10?",
    history: []
  })
})

Authentication

Free tier requires no authentication. For Pro access, include your API key:

// Header option 1
X-API-Key: your-key-here

// Header option 2
Authorization: Bearer your-key-here

LifeTrend™ Methodology

A composite relocation intelligence score (30-90) built from 7 decision dimensions:

Dimension	Weight	Source
Safety	22%	Numbeo Safety Index, Eurostat crime stats
Cost of Living	18%	Numbeo, national statistics (inverted — lower = better)
Healthcare	13%	WHO, Euro Health Consumer Index, OECD
Climate	12%	AEMET, IPMA, ISPRA, EMY, Meteo-France
Lifestyle	12%	Coworker.com, Startup Genome, TripAdvisor
Digital Infrastructure	10%	Speedtest, DESI 2024, EF EPI
Education	9%	International Schools Database, IBO.org

Raw scores are min-max normalized per dimension, then stretched to a 30-90 display range for readability. Updated quarterly.

MCP Server (AI assistants & agents)

Caterelo is also a Model Context Protocol server. Point Claude, ChatGPT or your own agent at https://caterelo.com/api/mcp (JSON-RPC 2.0 over HTTP) and it can call live tools instead of guessing from training data: list_regions, get_region, compare_regions, rank_regions, find_regions. Free tier: 10 req/min with attribution. Pro/commercial: same X-API-Key as the REST API. GET the endpoint for a machine-readable server card.

Pricing

Free

€0

10 requests/min
Score + level only
Top 5 ranking
No API key required
Ideal for testing

Pro

€49/month

100 requests/min
Full 7-dimension breakdown
All 90 regions in ranking
Raw normalization data
AI Advisor access
Priority support

Contact api@caterelo.com for enterprise plans, custom integrations, or embedded widget licensing.

Try It

Endpoint Value

Region IDs

All 90 region IDs follow the pattern {country}-{slug}:

ES: es-md es-ct es-an es-vc es-ga es-cl es-pv es-cn es-cm es-mu es-ar es-ib es-ex es-as es-na es-cb es-ri
IT: it-lom it-laz it-cam it-ven it-emi it-pie it-tos it-sic it-pug it-lig it-mar it-fri it-abr it-sar it-cal it-tre it-umb it-bas it-mol it-vda
PT: pt-l pt-alg pt-n pt-c pt-mad pt-alt
GR: gr-att gr-cm gr-cr gr-th gr-wg gr-em gr-cg gr-pe gr-ep gr-si gr-na gr-ii gr-wm
FR: fr-idf fr-pac fr-ara fr-occ fr-naq fr-bre fr-pdl fr-nor fr-hdf fr-ges fr-bfc fr-cvl fr-cor
HR: hr-zg hr-zgz hr-kzz hr-smz hr-kaz hr-vaz hr-kkz hr-bbz hr-pgz hr-lsz hr-vpz hr-psz hr-bpz hr-zdz hr-obz hr-skz hr-vsz hr-sdz hr-isz hr-dnz hr-mez