relocate.me APIrelocate.me ↗
Access relocate.me data via API: country overviews, visa guides, tech job listings, salary benchmarks, cost of living, and healthcare info across 9 endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/bc927a34-28bd-4703-9e12-7d59e5d351f6/get_countries_list' \ -H 'X-API-Key: $PARSE_API_KEY'
Get list of all available countries with their name, slug, and URL.
No input parameters required.
{
"type": "object",
"fields": {
"countries": "array of objects with name, slug, and url for each country"
},
"sample": {
"data": {
"countries": [
{
"url": "https://relocate.me/moving-to-germany",
"name": "Germany",
"slug": "germany"
},
{
"url": "https://relocate.me/moving-to-netherlands",
"name": "Netherlands",
"slug": "netherlands"
}
]
},
"status": "success"
}
}About the relocate.me API
The relocate.me API covers 9 endpoints that return structured relocation data including visa types, tech job listings, salary benchmarks, cost-of-living breakdowns, and healthcare overviews for countries worldwide. Starting with get_countries_list to retrieve available country slugs, you can then query per-country endpoints using those slugs to pull targeted data on visas, salaries, jobs, and living costs for any supported destination.
Country Overviews and Facts
The get_country_overview endpoint returns a facts object containing structured key-value pairs such as Capital, Currency, Population, Tax year, and Income tax rates, alongside a prose description, the names of the contributing author and moderator, and a last_updated date. The get_countries_list endpoint provides the full set of supported country_slug values (e.g. germany, netherlands, united-kingdom) that all per-country endpoints require as their primary input parameter.
Visas, Jobs, and Salaries
get_country_visas returns an array of visa objects with a type field and optional description and url per visa, plus the URL of the country's visa guide page. get_country_jobs returns live tech job postings with title, company, city, and url for each position, along with a count of total results — note that job counts reflect live postings and will vary over time. get_country_salaries exposes per-role salary data via a job_salaries array (each entry with role and salary) and an average_salary_info summary string. For a global view, get_salaries_overview ranks countries by average_monthly_net salary without requiring any input parameters.
Cost of Living and Healthcare
get_country_cost_of_living returns a costs object keyed by section heading (e.g. rent, utilities, food, transport) with content text as values, plus the URL of the source page. get_country_healthcare follows the same structure, with a healthcare object keyed by section topic — covering the healthcare system, insurance types, accessing care, and emergencies. Both endpoints accept a country_slug and return section-organized text suitable for display or further parsing.
Global Visa Coverage
get_visas_overview requires no input and returns an array of countries that have visa guides available, each with a name, slug, and url. This is useful for determining which countries have visa content before calling get_country_visas on a specific destination.
- Build a relocation comparison tool that surfaces salary benchmarks from
get_country_salariesalongside cost-of-living sections fromget_country_cost_of_living. - Populate a visa research dashboard by pulling visa types and descriptions from
get_country_visasfor multiple destination countries. - Aggregate live tech job listings across countries using
get_country_jobsto show job counts and employer names per destination. - Display country fact sheets — capital, currency, tax rates — sourced from the
factsobject returned byget_country_overview. - Rank countries by average net monthly salary using
get_salaries_overviewto produce a global compensation comparison. - Provide healthcare system summaries to relocating employees by section using
get_country_healthcareresponses. - Seed a relocation chatbot with structured country data by iterating over
get_countries_listand fetching per-country details.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does relocate.me have an official public developer API?+
What does `get_country_jobs` return, and how current is the data?+
get_country_jobs returns an array of job objects — each with title, company, city, and url — plus a count of total listings. Results reflect live job postings on relocate.me at the time of the request, so the count and specific listings will change as employers add or remove positions.Can I filter job listings by role, salary range, or company?+
get_country_jobs endpoint accepts only a country_slug and returns all available tech jobs for that country without additional filtering parameters. You can fork this API on Parse and revise it to add filtering by role or other criteria.Does the API return individual cost-of-living line items like a monthly rent figure or grocery price?+
get_country_cost_of_living endpoint returns section-level content as text blocks keyed by heading (e.g. rent, utilities, food) rather than discrete numeric line items per category. Structured per-item pricing data is not currently exposed. You can fork the API on Parse and revise it to extract specific numeric values from the content text.Are all countries supported for every endpoint?+
get_visas_overview and get_salaries_overview list which countries have guides available. Not every country returned by get_countries_list will have populated data for all endpoints — for example, healthcare or cost-of-living guides may be missing for less-covered destinations. Calling get_visas_overview first is a reliable way to confirm visa guide availability before querying get_country_visas.