# Numbeo API: Compare cost of living between two cities

> Compares living costs in two Numbeo cities: six price and purchasing-power differences, plus the monthly take-home salary needed in the destination for a similar standard of living (rent assumed in both cities).

Unofficial. Not affiliated with or endorsed by Numbeo.

- Page: https://fous.com/methods/numbeo.com/compare-cost-of-living
- Method: `numbeo.com/compare_cost_of_living`, version 1
- Website: numbeo.com
- Returns: six percent differences, required monthly salary, comparison link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `to_city` | string | yes | `"London"` | Destination city, such as Berlin or Berlin, Germany. |
| `currency` | string | no | `"euros"` | Currency for the salary calculation, such as GBP, EUR, or British pound. Defaults to the starting city's currency. |
| `from_city` | string | yes | `"Berlin"` | Starting city, such as London or London, United Kingdom. |
| `monthly_salary` | number | no | `3500` | Monthly take-home pay in the starting city, such as 5000. Default 5000. |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "to_city": "London",
  "currency": "euros",
  "from_city": "Berlin",
  "monthly_salary": 3500
}
```

Its output:

```json
{
  "to_city": "London",
  "from_city": "Berlin",
  "rent_percent": 95.8,
  "comparison_link": "https://www.numbeo.com/cost-of-living/compare_cities.jsp?country1=Germany&city1=Berlin&country2=United+Kingdom&city2=London&amount=3500&displayCurrency=EUR",
  "groceries_percent": 9.2,
  "consumer_prices_percent": 23.8,
  "required_monthly_salary": {
    "amount": 5063.5,
    "currency": "EUR"
  },
  "restaurant_prices_percent": 31.7,
  "local_purchasing_power_percent": 2.6,
  "consumer_prices_including_rent_percent": 44.7
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"numbeo.com/compare_cost_of_living","input":{"to_city":"London","currency":"euros","from_city":"Berlin","monthly_salary":3500}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- How much would I need to earn monthly in Lisbon to keep the same standard of living as in Madrid with 4200 euros take-home?
- Compare living costs between Toronto and Vancouver, I currently take home 6000 CAD a month
- What salary in Berlin, Germany matches my 3500 GBP monthly pay from London?
- Is Tokyo more expensive than Osaka for someone earning 450000 yen a month? Show price differences and comparison link.
- On numbeo.com, check how far my 5000 USD take-home from Austin would stretch in Denver in terms of purchasing power

## Input schema

```json
{
  "type": "object",
  "required": [
    "from_city",
    "to_city"
  ],
  "properties": {
    "to_city": {
      "type": "string",
      "description": "Destination city, such as Berlin or Berlin, Germany."
    },
    "currency": {
      "type": "string",
      "description": "Currency for the salary calculation, such as GBP, EUR, or British pound. Defaults to the starting city's currency."
    },
    "from_city": {
      "type": "string",
      "description": "Starting city, such as London or London, United Kingdom."
    },
    "monthly_salary": {
      "type": "number",
      "default": 5000,
      "minimum": 0.01,
      "description": "Monthly take-home pay in the starting city, such as 5000."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "from_city",
    "to_city",
    "consumer_prices_percent",
    "consumer_prices_including_rent_percent",
    "rent_percent",
    "restaurant_prices_percent",
    "groceries_percent",
    "local_purchasing_power_percent",
    "required_monthly_salary",
    "comparison_link"
  ],
  "properties": {
    "to_city": {
      "type": "string"
    },
    "from_city": {
      "type": "string"
    },
    "rent_percent": {
      "type": "number"
    },
    "comparison_link": {
      "type": "string"
    },
    "groceries_percent": {
      "type": "number"
    },
    "consumer_prices_percent": {
      "type": "number"
    },
    "required_monthly_salary": {
      "type": "object",
      "required": [
        "amount",
        "currency"
      ],
      "properties": {
        "amount": {
          "type": "number"
        },
        "currency": {
          "type": "string"
        }
      }
    },
    "restaurant_prices_percent": {
      "type": "number"
    },
    "local_purchasing_power_percent": {
      "type": "number"
    },
    "consumer_prices_including_rent_percent": {
      "type": "number"
    }
  }
}
```

## See more

- [Numbeo API: Get cost of living](https://fous.com/methods/numbeo.com/get-cost-of-living.md): Gets a city's current Numbeo cost of living indices, monthly estimates without rent, and typical prices. Add a country or state to tell apart cities with the same name.
- [Time and Date API: Convert time between cities](https://fous.com/methods/timeanddate.com/convert-time-between-cities.md): Converts a meeting time in one city to local times in other cities, with time zones and 09:00-17:00 working-hours status. Supports dates from 1970 to 2030; ambiguous clock-change times use the first occurrence.
- [Wise API: Compare transfer costs](https://fous.com/methods/wise.com/compare-transfer-costs.md): Compares what recipients get from Wise and other providers for a transfer amount and currency pair, with fees, rates and delivery times.
- [PayScale API: Get salary for a job title](https://fous.com/methods/payscale.com/get-salary.md): Gets typical pay for a job title from PayScale research pages. You can narrow it to a country and a city.
- [Zumper API: Get average rents by city](https://fous.com/methods/zumper.com/get-average-rents.md): Gets Zumper's current median monthly rents for studio through three-bedroom homes in a city, with monthly and yearly percentage changes. National rank is included only when the same-month U.S. national report ranks the city.
- [Google API: Convert currency amount](https://fous.com/methods/google.com/convert-currency.md): Converts an amount between two currencies using the current Google Finance quote. Rates may be delayed.
- [XE API: Convert currency](https://fous.com/methods/xe.com/convert-currency.md): Converts an amount between two currencies using XE's displayed mid-market rate. It also returns the rate time and an XE converter link. Rates are informational, not transfer quotes.
- [Hostelworld API: Search hostels](https://fous.com/methods/hostelworld.com/search-hostels.md): Finds available hostels, hotels and guesthouses on Hostelworld in a city for given dates, with per-night dorm and private room prices, ratings, facilities and booking links.
- [All Numbeo methods](https://fous.com/methods/numbeo.com.md)
