Numbeo API Documentation

To access our API:

If your client supports HTTPS, use the URL prefix: https://www.numbeo.com/api/
If your client does not support HTTPS, you can use the alternate URL prefix: http://www.numbeo.com:8008/api/
(Note: This may not work in browsers that enforce HSTS but should function in command-line clients such as wget or curl.)

For any questions or technical difficulties related to the Numbeo API, contact us at api@numbeo.com

Method: GET /api/cities

Description: Returns a list of cities in our database. Cities without available data are omitted.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 format.	no

Example:

/api/cities?api_key=your_api_key

Example response:

{
   "cities":[
      {
         "country":"Brazil",
         "city":"Sao Paulo",
         "latitude":-23.5503279,
         "city_id":7392,
         "longitude":-46.6339647
      },
      {
         "country":"United Kingdom",
         "city":"London",
         "latitude":51.5072759,
         "city_id":6512,
         "longitude":-0.1276597
      },
      {
         "country":"Australia",
         "city":"Sydney",
         "latitude":-33.8674869,
         "city_id":3581,
         "longitude":151.2069902
      }
   ]
}

Method: GET /api/price_items

Description: Returns a list of items from our main cost of living section.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes

Example:

/api/price_items?api_key=your_api_key

Example response:

{  
   "items":[  
      {  
         "category":"Restaurants",
         "cpi_factor":6,
         "item_id":3,
         "name":"McMeal at McDonalds (or Equivalent Combo Meal)",
         "rent_factor":0
      },
      {  
         "category":"Restaurants",
         "cpi_factor":5,
         "item_id":4,
         "name":"Domestic Beer (0.5 liter draught)",
         "rent_factor":0
      },
      {  
         "category":"Markets",
         "cpi_factor":31,
         "item_id":9,
         "name":"Loaf of Fresh White Bread (500g)",
         "rent_factor":0
      },
      {  
         "category":"Markets",
         "cpi_factor":28,
         "item_id":11,
         "name":"Eggs (12)",
         "rent_factor":0
      }
   ]
}

Method: GET /api/currency_exchange_rates

Description: Returns the current exchange rates used by Numbeo.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes

Example:

/api/currency_exchange_rates?api_key=your_api_key

Example response:

{
   "exchange_rates":[
      {
         "one_usd_to_currency":3.6731000000000003,
         "one_eur_to_currency":4.375342465753425,
         "currency":"AED"
      },
      {
         "one_usd_to_currency":1.2390999999999999,
         "one_eur_to_currency":1.4759976176295413,
         "currency":"AUD"
      },
      {
         "one_usd_to_currency":6.2471,
         "one_eur_to_currency":7.4414532459797496,
         "currency":"DKK"
      }
   ]
}

Method: GET /api/city_prices

Description: Returns current prices for a specified city.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`query`	The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: `'London, United Kingdom'`, `'New York, NY, United States'` and `'51.509865,-0.118092'`. Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs.	no
`city`	The name of the city as listed in the Numbeo database. Refer to the `/api/cities` endpoint for valid city names.	no
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 code format.	no
`city_id`	Internal city id as used in numbeo database	no
`strict_matching`	When using `query` parameter, setting this to `false` allows the system to resolve the query to a major city rather than the closest city when possible. The default value is: `true`.	no
`currency`	The currency in which you want the data to be estimated. Specify a valid currency code (e.g., USD, EUR, GBP).	no
`use_estimated`	When set to `false`, the engine will not attempt to estimate values from nearby cities for locations with low data coverage. The default value is `true`.	no

Example:

/api/city_prices?api_key=your_api_key&query=London,%20United%20Kingdom
/api/city_prices?api_key=your_api_key&city=London&country=United%20Kingdom
/api/city_prices?api_key=your_api_key&query=51.509865,-0.118092
/api/city_prices?api_key=your_api_key&query=LON

Example response:

{
   "name":"London, United Kingdom",
   "currency":"GBP",
   "contributors12months":943,
   "monthLastUpdate":4,
   "contributors":564,
   "yearLastUpdate":2022,
   "prices":[
      {
         "data_points":82,
         "item_id":1,
         "lowest_price":10,
         "average_price":15,
         "highest_price":30,
         "item_name":"Meal, Inexpensive Restaurant, Restaurants"
      },
      {
         "data_points":69,
         "item_id":5,
         "lowest_price":4,
         "average_price":5,
         "highest_price":7,
         "item_name":"Imported Beer (0.33 liter bottle), Restaurants"
      },
      {
         "data_points":71,
         "item_id":11,
         "lowest_price":1.2344128765489017,
         "average_price":2.2980851064307743,
         "highest_price":3.600000000144,
         "item_name":"Eggs (regular) (12), Markets"
      }
   ],
   "city_id":6512
}

Method: GET /api/country_prices

Description: Returns the latest price data for a specified country.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 format.	no
`currency`	The currency in which you want the data to be estimated. Specify a valid currency code (e.g., USD, EUR, GBP).	no

Example:

/api/country_prices?api_key=your_api_key&country=Kuwait

Example response:

{
   "monthLastUpdate":4,
   "contributors":45,
   "name":"Kuwait",
   "prices":[
      {
         "average_price":6.061485913570016,
         "item_name":"Meal, Inexpensive Restaurant, Restaurants",
         "highest_price":13,
         "item_id":1,
         "lowest_price":3.36080278998022,
         "data_points": 40
     },
     {
         "average_price":1.3874939824286925,
         "item_name":"Oranges (1kg), Markets",
         "highest_price":1.5,
         "item_id":111,
         "lowest_price":1.25,
         "data_points": 40
      },
      {
         "average_price":1.3975,
         "item_name":"Potato (1kg), Markets",
         "highest_price":1.79,
         "item_id":112,
         "lowest_price":0.8,
         "data_points": 22
      },
      {
         "average_price":2.0949999999999998,
         "item_name":"Lettuce (1 head), Markets",
         "highest_price":3.5,
         "item_id":113,
         "lowest_price":0.89,
         "data_points": 25
      },
      {
         "average_price":3.71844212292207,
         "item_name":"Cappuccino (regular), Restaurants",
         "highest_price":7,
         "item_id":114,
         "lowest_price":1.97376849168828,
         "data_points": 40
      }
   ],
   "yearLastUpdate":2012,
   "currency":"USD"
}

Method: GET /api/city_cost_estimator

Description: Estimates the cost of living for an individual or a family in a given city.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`query`	The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: `'London, United Kingdom'`, `'New York, NY, United States'` and `'51.509865,-0.118092'`. Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs.	no
`city`	The name of the city as listed in the Numbeo database. Refer to the `/api/cities` endpoint for valid city names.	no
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 code format.	no
`city_id`	Internal city id as used in numbeo database	no
`strict_matching`	When using `query` parameter, setting this to `false` allows the system to resolve the query to a major city rather than the closest city when possible. The default value is: `true`.	no
`currency`	The currency in which you want the data to be estimated. Specify a valid currency code (e.g., USD, EUR, GBP).	no
`household_members`	The number of the members in the household (default: 4)	no
`children`	The number of the children for which to add costs for preschool and school fees (default: 0)	no
`include_rent`	If set to true, the estimate will include rental cost (default: false)	no

Example:

/api/city_cost_estimator?api_key=your_api_key&query=London,%20United%20Kingdom&members=4&children=2&include_rent=true&currency=USD

Example response:

{
   "city_name":"London, United Kingdom",
   "household_members":4,
   "children":2,
   "currency":"USD",
   "overall_estimate":11745.345860115707,
   "city_id":6512,
   "breakdown":[
      {
         "estimate":851.7582208104193,
         "category":"Restaurants"
      },
      {
         "estimate":204.69409995334127,
         "category":"Going out"
      },
      {
         "estimate":978.8876853696561,
         "category":"Food at Home"
      },
      {
         "estimate":65.26440238073204,
         "category":"Drinks at Home"
      },
      {
         "estimate":738.5319384894608,
         "category":"Public Transport and Taxi"
      },
      {
         "estimate":263.2046891311094,
         "category":"Leisure and Sport Memberships"
      },
      {
         "estimate":368.6369360079844,
         "category":"Utilities"
      },
      {
         "estimate":134.3677037793451,
         "category":"Clothing and Shoes"
      },
      {
         "estimate":4180.452797310392,
         "category":"Rent"
      },
      {
         "estimate":3688.0066324803743,
         "category":"Childcare and School Fees"
      },
      {
         "estimate":271.5407544028932,
         "category":"Other Goods and Services"
      }
   ]
}

Method: GET /api/close_cities_with_prices

Description: Returns nearby cities that have price data in our database for a given location.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`query`	The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: `'London, United Kingdom'`, `'New York, NY, United States'` and `'51.509865,-0.118092'`. Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs.	no
`max_distance`	Max distance in km to look up for cities (from the source location provided). Default: 200	no
`min_contributors`	Minimum number of contributors for a city to be included in the response. Default: 10	no

Example:

/api/close_cities_with_prices?api_key=your_api_key&query=-12.40,130.8&min_contributors=2&max_distance=10000

Example response:

{
   "cities":[
      {
         "country":"Australia",
         "latitude":-12.461334,
         "name":"Darwin",
         "short_name":"Darwin",
         "city_id":3570,
         "longitude":130.841904
      },
      {
         "country":"Timor-Leste",
         "latitude":-8.5536809,
         "name":"Dili",
         "short_name":"Dili",
         "city_id":4836,
         "longitude":125.5784093
      },
      {
         "country":"Australia",
         "latitude":-23.7002104,
         "name":"Alice Springs",
         "short_name":"Alice Springs",
         "city_id":8304,
         "longitude":133.8806114
      },
      {
         "country":"Indonesia",
         "latitude":-3.03638,
         "name":"Jayapura",
         "short_name":"Jayapura",
         "city_id":4079,
         "longitude":139.925791727673
      },
      {
         "country":"Indonesia",
         "latitude":-5.1342962,
         "name":"Makassar",
         "short_name":"Makassar",
         "city_id":4082,
         "longitude":119.4124282
      },
      {
         "country":"Indonesia",
         "latitude":-8.581824,
         "name":"Mataram",
         "short_name":"Mataram",
         "city_id":4084,
         "longitude":116.106832
      },
      {
         "country":"Indonesia",
         "latitude":1.4708889,
         "name":"Manado",
         "short_name":"Manado",
         "city_id":7869,
         "longitude":124.8454608
      },
      {
         "country":"Australia",
         "latitude":-16.923978,
         "name":"Cairns",
         "short_name":"Cairns",
         "city_id":3567,
         "longitude":145.77086
      }
   ]
}

Method: GET /api/historical_city_prices

Description: Returns historical average prices (per year) for a specified city.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`query`	The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: `'London, United Kingdom'`, `'New York, NY, United States'` and `'51.509865,-0.118092'`. Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs.	no
`city`	The name of the city as listed in the Numbeo database. Refer to the `/api/cities` endpoint for valid city names.	no
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 code format.	no
`city_id`	Internal city id as used in numbeo database	no
`strict_matching`	When using `query` parameter, setting this to `false` allows the system to resolve the query to a major city rather than the closest city when possible. The default value is: `true`.	no
`currency`	The currency in which you want the data to be estimated. Specify a valid currency code (e.g., USD, EUR, GBP).	no

Example:

/api/historical_city_prices?api_key=your_api_key&query=London,%20United%20Kingdom

Example response:

{
   "entry":[
      {
         "amount":10.4,
         "year":2010,
         "item_id":1
      },
      {
         "amount":13.971830985915494,
         "year":2011,
         "item_id":1
      },
      {
         "amount":10,
         "year":2012,
         "item_id":1
      }
   ],
   "city":"London, United Kingdom",
   "currency":"GBP"
}

Method: GET /api/historical_country_prices

Description: Returns historical average prices (per year) for a specified country.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 format.	yes
`currency`	The currency in which you want the data to be estimated. Specify a valid currency code (e.g., USD, EUR, GBP).	no

Example:

/api/historical_country_prices?api_key=your_api_key&country=United%20Kingdom

Example response:

{
   "entry":[
      {
         "amount":630.1988400994201,
         "item_id":1,
         "year":2010
      },
      {
         "amount":361.95817904595947,
         "item_id":1,
         "year":2011
      },
      {
         "amount":1447.8327161838379,
         "item_id":2,
         "year":2011
      }
   ],
   "currency":"GBP",
   "country":"United Kingdom"
}

Method: GET /api/historical_country_prices_monthly

Description: Returns historical average prices (per month) for a specified country.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 format.	yes
`currency`	The currency in which you want the data to be estimated. Specify a valid currency code (e.g., USD, EUR, GBP).	no

Example:

/api/historical_country_prices_monthly?api_key=your_api_key&country=United%20Kingdom

Example response:

{
   "entry":[
      {
         "amount":361.95817904595947,
         "item_id":1,
         "year":2012,
         "currency":"GBP",
         "month":1,
         "contributors":13
      },
      {
         "amount":630.1988400994201,
         "item_id":2,
         "year":2012,
         "currency":"GBP",
         "month":1,
         "contributors":15
      },
   "country":"United Kingdom"
}

Method: GET /api/historical_currency_exchange_rates

Description: Returns historical exchange rates used by Numbeo, recorded at the beginning of each month.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`month`	Month	yes
`year`	Year	yes

Example:

/api/historical_currency_exchange_rates?api_key=your_api_key&month=3&year=2014

Example response:

{
   "month":2,
   "year":2013,
   "exchange_rates":[
      {
         "one_usd_to_currency":0.2722495984318423,
         "one_eur_to_currency":0.2014647028395633,
         "currency":"AED"
      },
      {
         "one_usd_to_currency":1.5762925598991173,
         "one_eur_to_currency":1.1664564943253468,
         "currency":"GBP"
      },
      {
         "one_usd_to_currency":0.018765246762994934,
         "one_eur_to_currency":0.013886282604616251,
         "currency":"INR"
      },
   ]
}

Method: GET /api/city_prices_raw

Description: Returns raw recent price data entries for a specified city. Note: Spam detection algorithms run every peridically. Some spam entries may not be identified immediately. If using this method, consider excluding data from the last 2 days. See also GET /api/city_prices_raw_deletion_log.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`query`	The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: `'London, United Kingdom'`, `'New York, NY, United States'` and `'51.509865,-0.118092'`. Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs.	no
`city`	The name of the city as listed in the Numbeo database. Refer to the `/api/cities` endpoint for valid city names.	no
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 code format.	no
`city_id`	Internal city id as used in numbeo database	no
`strict_matching`	When using `query` parameter, setting this to `false` allows the system to resolve the query to a major city rather than the closest city when possible. The default value is: `true`.	no
`since_internal_id`	If provided, the API call will return only entries with an `internal_id` greater than or equal to the specified value. When using this parameter, it is recommended to also use query `city_prices_raw_deletion_log` as well.	no

Example:

/api/city_prices_raw?api_key=your_api_key&query=London,%20United%20Kingdom

Example response:

{
   "entry":[
      {
         "date":"2022-04-26",
         "amount":32,
         "internal_id":7271110,
         "city":"London, United Kingdom",
         "item_id":1,
         "year":2022,
         "amount_usd":40.83606743566086,
         "item_name":"Meal, Inexpensive Restaurant, Restaurants",
         "amount_eur":38.06431935846538,
         "username_hash":"-1569481899",
         "month":4,
         "currency":"GBP",
         "entry_id":7571110,
         "timestamp":1651006920000
      },
      {
         "date":"2022-04-26",
         "amount":12,
         "internal_id":7270230,
         "city":"London, United Kingdom",
         "item_id":1,
         "year":2022,
         "amount_usd":15.313525288372823,
         "item_name":"Meal, Inexpensive Restaurant, Restaurants",
         "amount_eur":14.274119759424519,
         "username_hash":"-722855294",
         "month":4,
         "currency":"GBP",
         "entry_id":7570230,
         "timestamp":1650977339000
      }
      {
         "date":"2022-01-27",
         "amount":80,
         "internal_id":7056191,
         "city":"London, United Kingdom",
         "item_id":2,
         "year":2022,
         "amount_usd":107.45971939580772,
         "item_name":"Meal for 2 People, Mid-range Restaurant, Three-course, Restaurants",
         "amount_eur":95.77831059888643,
         "username_hash":"1886810117",
         "month":1,
         "currency":"GBP",
         "entry_id":7356191,
         "timestamp":1643324840000
      }
   ]
}

Method: GET /api/city_prices_raw_deletion_log

Description: Returns IDs of entries from city_prices_raw that were retroactively classified as spam and removed from the database.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`since_log_id`	If present, the call will return only entries having `log_id` greater or equal than the id provided	no

Example:

/api/city_prices_raw_deletion_log?api_key=your_api_key&since_log_id=290

Example response:

{
   "log":[
      {
         "log_id":290,
         "city_item_raw_internal_id":4666656
      },
      {
         "log_id":291,
         "city_item_raw_internal_id":4666657
      }
   ]
}

Method: GET /api/city_prices_archive_raw

Description: Returns archived raw price data entries for a specified city. Note: Data is periodically moved from the main database table to an archive table. This query retrieves archived data.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`query`	The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: `'London, United Kingdom'`, `'New York, NY, United States'` and `'51.509865,-0.118092'`. Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs.	no
`city`	The name of the city as listed in the Numbeo database. Refer to the `/api/cities` endpoint for valid city names.	no
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 code format.	no
`city_id`	Internal city id as used in numbeo database	no
`strict_matching`	When using `query` parameter, setting this to `false` allows the system to resolve the query to a major city rather than the closest city when possible. The default value is: `true`.	no
`currency`	The currency in which you want the data to be estimated. Specify a valid currency code (e.g., USD, EUR, GBP).	no

Example:

/api/city_prices_archive_raw?api_key=your_api_key&query=London,%20United%20Kingdom

Example response:

{
   "entry":[
      {
         "date":"2021-09-29",
         "amount":15,
         "internal_id":6810525,
         "city":"London, United Kingdom",
         "item_id":1,
         "year":2021,
         "amount_usd":20.32410167470598,
         "item_name":"Meal, Inexpensive Restaurant, Restaurants",
         "amount_eur":17.390866348707387,
         "username_hash":"-775442257",
         "month":9,
         "currency":"GBP",
         "entry_id":6810525,
         "timestamp":1632924638000
      },
      {
         "date":"2021-09-28",
         "amount":40,
         "internal_id":6807355,
         "city":"London, United Kingdom",
         "item_id":1,
         "year":2021,
         "amount_usd":54.85734347828472,
         "item_name":"Meal, Inexpensive Restaurant, Restaurants",
         "amount_eur":46.89085034368126,
         "username_hash":"1998590114",
         "month":9,
         "currency":"GBP",
         "entry_id":6807355,
         "timestamp":1632816815000
      }
   ]
}

Method: GET /api/indices

Description: Returns Numbeo's index values for a specified city.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`query`	The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: `'London, United Kingdom'`, `'New York, NY, United States'` and `'51.509865,-0.118092'`. Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs.	no
`city`	The name of the city as listed in the Numbeo database. Refer to the `/api/cities` endpoint for valid city names.	no
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 code format.	no
`city_id`	Internal city id as used in numbeo database	no
`strict_matching`	When using `query` parameter, setting this to `false` allows the system to resolve the query to a major city rather than the closest city when possible. The default value is: `true`.	no

Example:

/api/indices?api_key=your_api_key&query=London,%20United%20Kingdom

Example response:

{
   "crime_index":53.34230941855818,
   "cpi_and_rent_index":72.07527649109899,
   "purchasing_power_incl_rent_index":80.67989242778127,
   "property_price_to_income_ratio":16.705588892782238,
   "contributors_healthcare":359,
   "safety_index":46.65769058144182,
   "traffic_co2_index":1869.8414096916301,
   "traffic_inefficiency_index":189.4021258120608,
   "contributors_traffic":241,
   "rent_index":65.21959376191104,
   "health_care_index":70.75969570552323,
   "groceries_index":58.43652054116736,
   "contributors_property":98,
   "pollution_index":58.27208464176413,
   "traffic_time_index":43.95594713656387,
   "restaurant_price_index":76.89401514383184,
   "contributors_cost_of_living":564,
   "climate_index":88.25433798690545,
   "cpi_index":78.33661180190455,
   "quality_of_life_index":127.95751313724718,
   "contributors_pollution":370,
   "contributors_crime":1027,
   "traffic_index":155.89160368069412,
   "name":"London, United Kingdom",
   "city_id":6512
}

Method: GET /api/country_indices

Description: Returns Numbeo's index values for a specified country.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 format.	no

Example:

/api/country_indices?api_key=your_api_key&country=Kuwait

Example response:

{
   "health_care_index":66.75925925925927,
   "crime_index":38.84500915750915,
   "traffic_time_index":17,
   "purchasing_power_incl_rent_index":104.48707062276117,
   "cpi_index":77.32543080858119,
   "pollution_index":69.3103448275862,
   "traffic_index":93.60606499265447,
   "quality_of_life_index":141.4787210994602,
   "cpi_and_rent_index":58.15013366824719,
   "groceries_index":71.8735218572076,
   "safety_index":61.154990842490825,
   "name":"Kuwait",
   "rent_index":37.49969632054832,
   "traffic_co2_index":4256,
   "restaurant_price_index":75.45173244741275,
   "traffic_inefficiency_index":52.48906353257302,
   "property_price_to_income_ratio":6.989395647748136
}

Method: GET /api/city_crime

Description: Returns aggregate data on crime perception for a specified city.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`query`	The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: `'London, United Kingdom'`, `'New York, NY, United States'` and `'51.509865,-0.118092'`. Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs.	no
`city`	The name of the city as listed in the Numbeo database. Refer to the `/api/cities` endpoint for valid city names.	no
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 code format.	no
`city_id`	Internal city id as used in numbeo database	no
`strict_matching`	When using `query` parameter, setting this to `false` allows the system to resolve the query to a major city rather than the closest city when possible. The default value is: `true`.	no

Example:

/api/city_crime?api_key=your_api_key&query=London,%20United%20Kingdom

Example response:

{
   "worried_things_car_stolen":-0.07692307692307693, /* -2 is minimum value, +2 maximum value */
   "crime_increasing":0.45454545454545453, /* -2 is minimum value, +2 maximum value */
   "safe_alone_night":0.6666666666666666, /* -2 is minimum value, +2 maximum value */
   "worried_mugged_robbed":-0.8484848484848485, /* -2 is minimum value, +2 maximum value */
   "worried_insulted":-0.47692307692307695, /* -2 is minimum value, +2 maximum value */
   "problem_violent_crimes":-0.6307692307692307, /* -2 is minimum value, +2 maximum value */
   "index_crime":41.098111957486964, /* 0 minimum, 100 maximum */
   "contributors":69,
   "monthLastUpdate":3,
   "level_of_crime":-0.5606060606060606, /* -2 is minimum value, +2 maximum value */
   "worried_skin_ethnic_religion":-0.7272727272727273, /* -2 is minimum value, +2 maximum value */
   "problem_drugs":0.015151515151515152, /* -2 is minimum value, +2 maximum value */
   "city_id":6512,
   "name":"London, United Kingdom",
   "safe_alone_daylight":1.393939393939394, /* -2 is minimum value, +2 maximum value */
   "problem_corruption_bribery":1.4126984126984128, /* -2 is minimum value, +2 maximum value */
   "problem_property_crimes":-0.10606060606060606, /* -2 is minimum value, +2 maximum value */
   "worried_home_broken":-0.5692307692307692, /* -2 is minimum value, +2 maximum value */
   "worried_attacked":-0.75, /* -2 is minimum value, +2 maximum value */
   "worried_car_stolen":-0.21212121212121213, /* -2 is minimum value, +2 maximum value */
   "index_safety":58.90188804251303, /* 0 minimum, 100 maximum */
   "yearLastUpdate":2015
}

Method: GET /api/city_crime_raw

Description: Returns raw user input data on crime perception for a specified city.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`query`	The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: `'London, United Kingdom'`, `'New York, NY, United States'` and `'51.509865,-0.118092'`. Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs.	no
`city`	The name of the city as listed in the Numbeo database. Refer to the `/api/cities` endpoint for valid city names.	no
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 code format.	no
`city_id`	Internal city id as used in numbeo database	no
`strict_matching`	When using `query` parameter, setting this to `false` allows the system to resolve the query to a major city rather than the closest city when possible. The default value is: `true`.	no

Example:

/api/city_crime_raw?api_key=your_api_key&query=London,%20United%20Kingdom

Example response:

{
   "city_id":6189,
   "name":"London, United Kingdom",
   "entries":[
      {
         "worried_things_car_stolen":-1,  /* -2 is minimum value, +2 maximum value */
         "crime_increasing":0, /* -2 is minimum value, +2 maximum value */
         "safe_alone_night":2, /* -2 is minimum value, +2 maximum value */
         "worried_mugged_robbed":-2, /* -2 is minimum value, +2 maximum value */
         "worried_insulted":-2, /* -2 is minimum value, +2 maximum value */
         "username_hash":"-1469710680",
         "problem_violent_crimes":-2, /* -2 is minimum value, +2 maximum value */
         "date":"2013-03-17",
         "id":4663,
         "city_id":6189,
         "level_of_crime":-2, /* -2 is minimum value, +2 maximum value */
         "worried_skin_ethnic_religion":-2, /* -2 is minimum value, +2 maximum value */
         "problem_drugs":1, /* -2 is minimum value, +2 maximum value */
         "month":3,
         "year":2013,
         "safe_alone_daylight":2, /* -2 is minimum value, +2 maximum value */
         "problem_corruption_bribery":1, /* -2 is minimum value, +2 maximum value */
         "problem_property_crimes":-1, /* -2 is minimum value, +2 maximum value */
         "worried_home_broken":-1, /* -2 minimum value, +2 maximum value */
         "worried_attacked":-2, /* -2 minimum value, +2 maximum value */
         "worried_car_stolen":1 /* -2 is a minimum value, +2 maximum value */
      },
      {
         "worried_things_car_stolen":2,
         "crime_increasing":0,
         "safe_alone_night":-2,
         "worried_mugged_robbed":-1,
         "worried_insulted":1,
         "username_hash":"357397680",
         "problem_violent_crimes":-1,
         "date":"2014-11-03",
         "id":18674,
         "city_id":6189,
         "level_of_crime":1,
         "worried_skin_ethnic_religion":-1,
         "problem_drugs":2,
         "month":11,
         "year":2014,
         "safe_alone_daylight":2,
         "problem_corruption_bribery":2,
         "problem_property_crimes":2,
         "worried_home_broken":2,
         "worried_attacked":1,
         "worried_car_stolen":2
      },
      {
         "worried_things_car_stolen":1,
         "crime_increasing":2,
         "safe_alone_night":-2,
         "worried_mugged_robbed":-1,
         "worried_insulted":2,
         "username_hash":"155474068",
         "problem_violent_crimes":-1,
         "date":"2014-12-02",
         "id":20357,
         "city_id":6189,
         "level_of_crime":1,
         "worried_skin_ethnic_religion":2,
         "problem_drugs":1,
         "month":12,
         "year":2014,
         "safe_alone_daylight":1,
         "problem_corruption_bribery":1,
         "problem_property_crimes":1,
         "worried_home_broken":1,
         "worried_attacked":-1,
         "worried_car_stolen":2
      }
   ]
}

Method: GET /api/city_healthcare

Description: Returns aggregate data on healthcare quality perception for a specified city.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`query`	The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: `'London, United Kingdom'`, `'New York, NY, United States'` and `'51.509865,-0.118092'`. Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs.	no
`city`	The name of the city as listed in the Numbeo database. Refer to the `/api/cities` endpoint for valid city names.	no
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 code format.	no
`city_id`	Internal city id as used in numbeo database	no
`strict_matching`	When using `query` parameter, setting this to `false` allows the system to resolve the query to a major city rather than the closest city when possible. The default value is: `true`.	no

Example:

/api/city_healthcare?api_key=your_api_key&query=London,%20United%20Kingdom

Example response:

{
   "location":0.75, /* -2 is a minimum value, +2 maximum value */
   "speed":0.15, /* -2 is a minimum value, +2 maximum value */
   "modern_equipment":0.7368421052631579, /* -2 is a minimum value, +2 maximum value */
   "accuracy_and_completeness":0.3, /* -2 is a minimum value, +2 maximum value */
   "cost":0.45, /* -2 is a minimum value, +2 maximum value */
   "friendliness_and_courtesy":-0.3684210526315789, /* -2 is a minimum value, +2 maximum value */
   "responsiveness_waitings":-0.5263157894736842, /* -2 is a minimum value, +2 maximum value */
   "contributors":20,
   "city_id":6189,
   "monthLastUpdate":2,
   "skill_and_competency":0.5, /* -2 is a minimum value, +2 maximum value */
   "insurance_type":{
      "Employer Sponsored":10, /* Percentage of contributors reporting that insurance type */
      "None":5,
      "Private":5,
      "Public":80
   },
   "name":"London, United Kingdom",
   "index_healthcare":56.78362573099415,
   "yearLastUpdate":2015
}

Method: GET /api/city_healthcare_raw

Description: Returns raw user input data on healthcare quality perception for a specified city.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`query`	The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: `'London, United Kingdom'`, `'New York, NY, United States'` and `'51.509865,-0.118092'`. Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs.	no
`city`	The name of the city as listed in the Numbeo database. Refer to the `/api/cities` endpoint for valid city names.	no
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 code format.	no
`city_id`	Internal city id as used in numbeo database	no
`strict_matching`	When using `query` parameter, setting this to `false` allows the system to resolve the query to a major city rather than the closest city when possible. The default value is: `true`.	no

Example:

/api/city_healthcare_raw?api_key=your_api_key&query=London,%20United%20Kingdom

Example response:

{
   "city_id":6189,
   "name":"London, United Kingdom",
   "entries":[
      {
         "speed":1, /* -2 is a minimum value, +2 maximum value */
         "location":0, /* -2 is a minimum value, +2 maximum value */
         "accuracy_and_completeness":-1, /* -2 is a minimum value, +2 maximum value */
         "username_hash":"-1399346660", 
         "date":"2011-07-19",
         "cost":1, /* -2 is a minimum value, +2 maximum value */
         "friendliness_and_courtesy":-1, /* -2 is a minimum value, +2 maximum value */
         "responsiveness_waitings":-1, /* -2 is a minimum satisfaction, +2 maximum satisfaction */
         "id":1,
         "city_id":6189,
         "skill_and_competency":0, /* -2 is a minimum value, +2 maximum value */
         "insurance_type":"Public",
         "month":7,
         "year":2011
      },
      {
         "location":0, /* -2 is a minimum value, +2 maximum value */
         "speed":2, /* -2 is a minimum value, +2 maximum value */
         "modern_equipment":-2, /* -2 is a minimum value, +2 maximum value */
         "accuracy_and_completeness":1, /* -2 is a minimum value, +2 maximum value */
         "username_hash":"2018885244", 
         "date":"2011-09-05",
         "cost":-1,
         "friendliness_and_courtesy":0, /* -2 is a minimum value, +2 maximum value */
         "responsiveness_waitings":2, /* -2 is a minimum satisfaction, +2 maximum satisfaction */
         "id":119,
         "city_id":6189,
         "skill_and_competency":-1,
         "insurance_type":"Public",
         "month":9,
         "type_described":"Private",
         "year":2011
      }
   ]
}

Method: GET /api/city_pollution

Description: Returns aggregate pollution perception data for a specified city.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`query`	The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: `'London, United Kingdom'`, `'New York, NY, United States'` and `'51.509865,-0.118092'`. Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs.	no
`city`	The name of the city as listed in the Numbeo database. Refer to the `/api/cities` endpoint for valid city names.	no
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 code format.	no
`city_id`	Internal city id as used in numbeo database	no
`strict_matching`	When using `query` parameter, setting this to `false` allows the system to resolve the query to a major city rather than the closest city when possible. The default value is: `true`.	no

Example:

/api/city_pollution?api_key=your_api_key&query=London,%20United%20Kingdom

Example response:

{
   "green_and_parks_quality":1.2062146892655368,
   "pm2.5":12,
   "comfortable_to_spend_time":0.19220055710306408,
   "pm10":23,
   "air_quality":-0.5388888888888889,
   "garbage_disposal_satisfaction":0.335243553008596,
   "index_pollution":58.27208464176413,
   "drinking_water_quality_accessibility":0.7301136363636364,
   "name":"London, United Kingdom",
   "monthLastUpdate":4,
   "clean_and_tidy":0.056338028169014086,
   "noise_and_light_pollution":0.2,
   "contributors":370,
   "yearLastUpdate":2022,
   "water_pollution":-0.3659942363112392,
   "city_id":6512
}

Method: GET /api/city_pollution_raw

Description: Returns raw user input data on pollution perception for a specified city.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`query`	The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: `'London, United Kingdom'`, `'New York, NY, United States'` and `'51.509865,-0.118092'`. Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs.	no
`city`	The name of the city as listed in the Numbeo database. Refer to the `/api/cities` endpoint for valid city names.	no
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 code format.	no
`city_id`	Internal city id as used in numbeo database	no
`strict_matching`	When using `query` parameter, setting this to `false` allows the system to resolve the query to a major city rather than the closest city when possible. The default value is: `true`.	no

Example:

/api/city_pollution_raw?api_key=your_api_key&query=London,%20United%20Kingdom

Example response:

{
   "city_id":6512,
   "name":"London, United Kingdom",
   "entries":[
      {
         "drinking_water_quality_accessibility":0, /* -2 is a minimum value, +2 maximum value */
         "noise_and_light_pollution":-1, /* -2 is a minimum value, +2 maximum value */
         "water_pollution":1, /* -2 is a minimum value, +2 maximum value */
         "username_hash":"2018885244",
         "date":"2011-08-14",
         "id":1,
         "city_id":6512,
         "garbage_disposal_satisfaction":0, /* -2 is a minimum value, +2 maximum value */
         "month":8,
         "clean_and_tidy":0, /* -2 is a minimum value, +2 maximum value */
         "air_quality":-1, /* -2 is a minimum value, +2 maximum value */
         "year":2011,
         "comfortable_to_spend_time":0, /* -2 is a minimum value, +2 maximum value */
         "green_and_parks_quality":-1 /* -2 is a minimum value, +2 maximum value */
      },
      {
         "drinking_water_quality_accessibility":0,
         "noise_and_light_pollution":-1,
         "water_pollution":2,
         "username_hash":"2018885244",
         "date":"2011-09-05",
         "id":140,
         "city_id":6512,
         "garbage_disposal_satisfaction":1,
         "month":9,
         "clean_and_tidy":0,
         "air_quality":-1,
         "year":2011,
         "comfortable_to_spend_time":0,
         "green_and_parks_quality":-1
      }
   ]
}

Method: GET /api/city_traffic

Description: Returns aggregate commute and traffic analysis for a specified city.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`query`	The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: `'London, United Kingdom'`, `'New York, NY, United States'` and `'51.509865,-0.118092'`. Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs.	no
`city`	The name of the city as listed in the Numbeo database. Refer to the `/api/cities` endpoint for valid city names.	no
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 code format.	no
`city_id`	Internal city id as used in numbeo database	no
`strict_matching`	When using `query` parameter, setting this to `false` allows the system to resolve the query to a major city rather than the closest city when possible. The default value is: `true`.	no

Example:

/api/city_traffic?api_key=your_api_key&query=London,%20United%20Kingdom

Example response:

{
   "analyze using Motorbike":{
      "time_waiting":0,
      "time_driving":0,
      "time_tram":0,
      "time_other":0,
      "distance":10.0584,
      "time_bike":0,
      "time_train":0,
      "time_motorbike":35,
      "time_walking":0.75,
      "count":4,
      "time_bus":0
   },
   "analyze using Train/Metro":{
      "time_waiting":6.01,
      "time_driving":0,
      "time_tram":0,
      "time_other":0.19,
      "distance":19.702807616,
      "time_bike":0,
      "time_train":36.67,
      "time_motorbike":0,
      "time_walking":11.88,
      "count":100,
      "time_bus":1.98
   },
   "overall_average_analyze":{
      "time_waiting":3.33920704845815,
      "time_driving":4.709251101321586,
      "time_tram":0,
      "time_other":0.14977973568281938,
      "distance":14.430506699559471,
      "time_bike":3.356828193832599,
      "time_train":17.237885462555067,
      "time_motorbike":0.6299559471365639,
      "time_walking":10.317180616740089,
      "count":241,
      "time_bus":4.215859030837004
   },
   "analyze using Bus/Trolleybus":{
      "time_waiting":5.238095238095238,
      "time_driving":0,
      "time_tram":0,
      "time_other":0,
      "distance":13.365933104761908,
      "time_bike":0,
      "time_train":1.1904761904761905,
      "time_motorbike":0,
      "time_walking":7.9523809523809526,
      "count":21,
      "time_bus":35.904761904761905
   },
   "index_co2_emission":1869.8414096916301,
   "analyze using Car":{
      "time_waiting":0,
      "time_driving":44.5,
      "time_tram":0,
      "time_other":0,
      "distance":22.536361599999996,
      "time_bike":0,
      "time_train":0,
      "time_motorbike":0,
      "time_walking":1.125,
      "count":24,
      "time_bus":0
   },
   "primary_means_percentage_map":{
      "Walking":19.246861924686193,
      "Tram/Streetcar":0,
      "Train/Metro":41.84100418410041,
      "Car":10.0418410041841,
      "Bus/Trolleybus":8.786610878661087,
      "Working from Home":5.857740585774058,
      "Bicycle":12.552301255230125,
      "Motorcycle":1.6736401673640167
   },
   "index_time_exp":3017.4860798350724,
   "index_time":43.95594713656387,
   "index_traffic":155.89160368069412,
   "name":"London, United Kingdom",
   "analyze using Bike":{
      "time_waiting":0,
      "time_driving":0,
      "time_tram":0,
      "time_other":0.3,
      "distance":7.6608582400000005,
      "time_bike":25.4,
      "time_train":0,
      "time_motorbike":0,
      "time_walking":0.26666666666666666,
      "count":30,
      "time_bus":0
   },
   "index_inefficiency":189.4021258120608,
   "analyze using Walking":{
      "time_waiting":1.0217391304347827,
      "time_driving":0.021739130434782608,
      "time_tram":0,
      "time_other":0.13043478260869565,
      "distance":4.604948660869566,
      "time_bike":0,
      "time_train":4.804347826086956,
      "time_motorbike":0.06521739130434782,
      "time_walking":20.630434782608695,
      "count":46,
      "time_bus":0.10869565217391304
   },
   "contributors":241,
   "city_id":6512
}

Method: GET /api/city_traffic_raw

Description: Returns raw user-submitted data on commute time and traffic perception for a specified city.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`query`	The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: `'London, United Kingdom'`, `'New York, NY, United States'` and `'51.509865,-0.118092'`. Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs.	no
`city`	The name of the city as listed in the Numbeo database. Refer to the `/api/cities` endpoint for valid city names.	no
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 code format.	no
`city_id`	Internal city id as used in numbeo database	no
`strict_matching`	When using `query` parameter, setting this to `false` allows the system to resolve the query to a major city rather than the closest city when possible. The default value is: `true`.	no

Example:

/api/city_traffic_raw?api_key=your_api_key&query=London,%20United%20Kingdom

Example response:

{
   "entries":[
      {
         "date":"2019-12-20",
         "time_driving":0,
         "time_other":0,
         "distance":3.5,
         "year":2019,
         "time_leaving_home_hh":8,
         "time_leaving_home_mm":45,
         "time_waiting":3,
         "username_hash":"1988098946",
         "time_tram":0,
         "month":12,
         "time_bike":0,
         "time_train":7,
         "time_walking":15,
         "time_motorbike":0,
         "wfh":0,
         "id":34258,
         "time_bus":0,
         "city_id":6512,
         "status":"employed"
      },
      {
         "date":"2017-03-04",
         "time_driving":0,
         "time_other":0,
         "distance":18,
         "year":2017,
         "time_leaving_home_hh":5,
         "time_leaving_home_mm":55,
         "time_waiting":5,
         "username_hash":"-443517086",
         "time_tram":0,
         "month":3,
         "time_bike":0,
         "time_train":43,
         "time_walking":20,
         "time_motorbike":0,
         "wfh":0,
         "id":12553,
         "time_bus":0,
         "city_id":6512,
         "status":"employed"
      }
   ],
   "name":"London, United Kingdom",
   "city_id":6512
}

Method: GET /api/country_crime

Description: Returns aggregate crime perception data for a specified country.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 format.	no

Example:

/api/country_crime?api_key=your_api_key&country=Poland

Example response:

{
   "worried_things_car_stolen":-0.36507936507936506, /* -2 minimum value, +2 maximum value */
   "contributors":198,
   "crime_increasing":-0.5263157894736842,
   "safe_alone_night":0.3299492385786802,
   "worried_mugged_robbed":-0.734375,
   "worried_insulted":-0.7157894736842105,
   "problem_violent_crimes":-1.2135416666666667,
   "index_crime":31.771885317818157,
   "monthLastUpdate":3,
   "level_of_crime":-0.8115183246073299,
   "worried_skin_ethnic_religion":-0.9947916666666666,
   "problem_drugs":-1.036649214659686,
   "name":"Poland",
   "safe_alone_daylight":1.5606060606060606,
   "problem_corruption_bribery":-0.1638418079096045,
   "problem_property_crimes":-0.061855670103092786,
   "worried_home_broken":-0.9119170984455959,
   "worried_attacked":-0.6335078534031413,
   "worried_car_stolen":-0.7947368421052632,
   "index_safety":68.22811468218183,
   "yearLastUpdate":2015
}

Method: GET /api/country_healthcare

Description: Returns aggregate healthcare quality perception data for a specified country.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 format.	no

Example:

/api/country_healthcare?api_key=your_api_key&country=Poland

Example response:

{
   "contributors":78,
   "speed":0.06493506493506493, /* -2 minimum value, +2 maximum value */
   "location":0.6842105263157895, /* -2 minimum value, +2 maximum value */
   "modern_equipment":1.2, /* -2 minimum value, +2 maximum value */
   "accuracy_and_completeness":0.43243243243243246,
   "cost":0.38666666666666666,
   "friendliness_and_courtesy":0.04,
   "responsiveness_waitings":-0.7105263157894737,
   "reportees":78,
   "monthLastUpdate":3,
   "skill_and_competency":0.37662337662337664,
   "insurance_type":{
      "Employer Sponsored":21.794871794871796,
      "None":1.282051282051282,
      "Private":14.102564102564102,
      "Public":62.82051282051282
   },
   "name":"Poland",
   "index_healthcare":57.94724560514035,
   "yearLastUpdate":2015
}

Method: GET /api/country_pollution

Description: Returns aggregate pollution perception data for a specified country.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 format.	no

Example:

/api/country_pollution?api_key=your_api_key&country=Poland

Example response:

{
   "index_pollution":49.71328236217564,
   "monthLastUpdate":3,
   "contributors":264,
   "noise_and_light_pollution":-0.2765957446808511, /* -2 minimum value, +2 maximum value */
   "garbage_disposal_satisfaction":0.5473684210526316, /* -2 minimum value, +2 maximum value */
   "drinking_water_quality_accessibility":0.7604166666666666, /* -2 minimum value, +2 maximum value */
   "water_pollution":-0.6421052631578947, /* -2 minimum value, +2 maximum value */
   "name":"Poland",
   "clean_and_tidy":0.30526315789473685, /* -2 minimum value, +2 maximum value */
   "air_quality":-0.03435114503816794, /* -2 minimum value, +2 maximum value */
   "comfortable_to_spend_time":0.2681564245810056, /* -2 minimum value, +2 maximum value */
   "green_and_parks_quality":0.9361702127659575, /* -2 minimum value, +2 maximum value */
   "yearLastUpdate":2015
}

Method: GET /api/country_traffic

Description: Returns aggregate traffic perception data for a specified country.

Parameters:

Parameter name	Description	Mandatory
`api_key`	Your API Key	yes
`country`	The name of the country, as listed in the Numbeo database, or provided in ISO 3166 format.	no

Example:

/api/country_traffic?api_key=your_api_key&country=Poland

Example response:

{
   "index_traffic":116.36304290977134,
   "index_co2_emission":2750.65,
   "analyze using Bike":{
      "time_bike":21.5,
      "distance":6.925,
      "time_bus":0,
      "count":8,
      "time_waiting":0,
      "time_train":1.875,
      "time_driving":0,
      "time_walking":0.75,
      "time_motorbike":0,
      "time_other":0
   },
   "index_time":33.70625,
   "analyze using Motorbike":{
      "time_bike":0,
      "distance":7,
      "time_bus":0,
      "count":1,
      "time_waiting":0,
      "time_train":0,
      "time_driving":0,
      "time_walking":0,
      "time_motorbike":15,
      "time_other":0
   },
   "index_time_exp":392.4017206429015,
   "analyze using Bus":{
      "time_bike":0.8333333333333334,
      "distance":9.0875,
      "time_bus":25.458333333333332,
      "count":24,
      "time_waiting":5.854166666666667,
      "time_train":1.25,
      "time_driving":0.4166666666666667,
      "time_walking":8.333333333333334,
      "time_motorbike":0.4166666666666667,
      "time_other":0.8333333333333334
   },
   "reportees":93,
   "analyze using Car":{
      "time_bike":0,
      "distance":14.474074074074075,
      "time_bus":0,
      "count":27,
      "time_waiting":0,
      "time_train":0,
      "time_driving":24.59259259259259,
      "time_walking":2.740740740740741,
      "time_motorbike":0,
      "time_other":0
   },
   "primary_means_percentage_map":{
      "Car":29.347826086956523,
      "Working from Home":14.130434782608695,
      "Train":9.782608695652174,
      "Bike":8.695652173913043,
      "Walking":10.869565217391305,
      "Bus":26.08695652173913,
      "Motorbike":1.0869565217391304
   },
   "name":"Poland",
   "index_inefficiency":108.1812400671986,
   "analyze using Walking":{
      "time_bike":2.8,
      "distance":4.13,
      "time_bus":2.2,
      "count":10,
      "time_waiting":1.5,
      "time_train":2.7,
      "time_driving":0.3,
      "time_walking":19.6,
      "time_motorbike":0,
      "time_other":0
   },
   "overall_average_analyze":{
      "time_bike":2.75,
      "distance":11.057500000000001,
      "time_bus":8.725,
      "count":93,
      "time_waiting":2.49375,
      "time_train":3.8625,
      "time_driving":8.525,
      "time_walking":6.7,
      "time_motorbike":0.3125,
      "time_other":0.3375
   },
   "analyze using Train":{
      "time_bike":0,
      "distance":18.555555555555557,
      "time_bus":7.222222222222222,
      "count":9,
      "time_waiting":4.444444444444445,
      "time_train":26,
      "time_driving":0.5555555555555556,
      "time_walking":6.222222222222222,
      "time_motorbike":0,
      "time_other":0
   }
}

Method: GET /api/rankings_by_city_current

Description: Returns current rankings for cities based on a specified section of the Numbeo website (e.g., cost of living, property prices, crime rates). Note: This includes major cities and is updated continuously.

Parameters:

Parameter name Description Mandatory

api_key Your API Key yes

section

Specifies the desired section using the corresponding numerical value:

section=1	Cost of Living
section=2	Property Prices
section=4	Traffic
section=7	Crime
section=8	Pollution
section=12	Quality of Life

yes

Example:

/api/rankings_by_city_current?api_key=your_api_key&section=1

Example response:

[
  {
    "country": "Switzerland",
    "city_name": "Basel",
    "cpi_and_rent_index": 90.1359163150788,
    "rent_index": 47.72953844461662,
    "purchasing_power_incl_rent_index": 135.17535795816121,
    "restaurant_price_index": 127.7220643349051,
    "groceries_index": 124.35743301742603,
    "city_id": 6348,
    "cpi_index": 128.62588475320365
  },
  {
    "country": "Indonesia",
    "city_name": "Surabaya",
    "cpi_and_rent_index": 20.319506883154343,
    "rent_index": 6.5636891860185465,
    "purchasing_power_incl_rent_index": 36.817975365157515,
    "restaurant_price_index": 15.650058627568445,
    "groceries_index": 37.54757115208836,
    "city_id": 4095,
    "cpi_index": 32.80491628597314
  },
  {
    "country": "Bangladesh",
    "city_name": "Dhaka",
    "cpi_and_rent_index": 19.896900394123126,
    "rent_index": 6.016429903057122,
    "purchasing_power_incl_rent_index": 38.014869660619254,
    "restaurant_price_index": 20.25797768805653,
    "groceries_index": 29.87221868007943,
    "city_id": 3669,
    "cpi_index": 32.49545037496427
  }
]

Method: GET /api/rankings_by_city_historical

Description: Returns all historical rankings by city for a specified section of the Numbeo website (e.g., cost of living, property prices, crime).

Parameters:

Parameter name Description Mandatory

api_key Your API Key yes

section

Specifies the desired section using the corresponding numerical value:

section=1	Cost of Living
section=2	Property Prices
section=4	Traffic
section=7	Crime
section=8	Pollution
section=12	Quality of Life

yes

Example:

/api/rankings_by_city_historical?api_key=your_api_key&section=1

Example response:

{
  "2009": [
    {
      "country": "France",
      "city_name": "Paris",
      "cpi_and_rent_index": 115.352399333561,
      "rent_index": 96.3917647058824,
      "purchasing_power_incl_rent_index": 39.3783859771547,
      "restaurant_price_index": 116.526933333333,
      "groceries_index": 117.046356562731,
      "city_id": 5426,
      "cpi_index": 127.819456981736
    },
    {
      "country": "Ireland",
      "city_name": "Dublin",
      "cpi_and_rent_index": 111.119487756274,
      "rent_index": 87.5817647058824,
      "purchasing_power_incl_rent_index": 59.2501915246213,
      "restaurant_price_index": 131.562666666667,
      "groceries_index": 154.514000113591,
      "city_id": 5601,
      "cpi_index": 126.596087350027
    }
  ],
  "2018-mid": [
    {
      "country": "Bermuda",
      "city_name": "Hamilton",
      "cpi_and_rent_index": 121.21310196711634,
      "rent_index": 103.02749441958166,
      "purchasing_power_incl_rent_index": 114.19019787213726,
      "restaurant_price_index": 151.76846512406146,
      "groceries_index": 126.56376738455917,
      "city_id": 2207,
      "cpi_index": 137.55962670186702
    },
    {
      "country": "Switzerland",
      "city_name": "Zurich",
      "cpi_and_rent_index": 97.39167011466212,
      "rent_index": 62.617191903827496,
      "purchasing_power_incl_rent_index": 142.3854838603438,
      "restaurant_price_index": 127.14225929060643,
      "groceries_index": 127.35041423050669,
      "city_id": 6379,
      "cpi_index": 128.64945827079754
    }
  ]
}

Method: GET /api/rankings_by_country_historical

Description: Returns all historical rankings by country for a specified section of the Numbeo website (e.g., cost of living, property prices, crime).

Parameters:

Parameter name Description Mandatory

api_key Your API Key yes

section

Specifies the desired section using the corresponding numerical value:

section=1	Cost of Living
section=2	Property Prices
section=4	Traffic
section=7	Crime
section=8	Pollution
section=12	Quality of Life

yes

Example:

/api/rankings_by_country_historical?api_key=your_api_key&section=1

Example response:

{
  "2009": [
    {
      "country": "Ireland",
      "cpi_and_rent_index": 110.105298692167,
      "rent_index": 85.8543137254902,
      "purchasing_power_incl_rent_index": 59.7959499668058,
      "restaurant_price_index": 131.562666666667,
      "groceries_index": 154.514000113591,
      "cpi_index": 126.050884562128
    },
    {
      "country": "Netherlands",
      "cpi_and_rent_index": 103.170301282321,
      "rent_index": 71.8619607843138,
      "purchasing_power_incl_rent_index": 41.5522342036017,
      "restaurant_price_index": 108.507875555556,
      "groceries_index": 90.1064803771228,
      "cpi_index": 123.756262328561
    }
],
  "2018-mid": [
    {
      "country": "Switzerland",
      "cpi_and_rent_index": 87.3258276290233,
      "rent_index": 51.00182398934652,
      "purchasing_power_incl_rent_index": 130.08721350697192,
      "restaurant_price_index": 122.60422897314118,
      "groceries_index": 114.99324460018998,
      "cpi_index": 119.97644006576004
    },
    {
      "country": "Iceland",
      "cpi_and_rent_index": 84.89252009793405,
      "rent_index": 54.02663892840061,
      "purchasing_power_incl_rent_index": 93.214756941842,
      "restaurant_price_index": 125.93994605576913,
      "groceries_index": 99.57874164979359,
      "cpi_index": 112.63698168266963
    }
  ]
}

Explanation of the terms used:

contributors12months	The number of contributors who have submitted data in the past 12 months
monthLastUpdate	The month when the data was last updated
yearLastUpdate	The year of the last update
contributors	The total number of contributors whose data was used in the calculations (as we use an adaptive archive policy)
cpi_factor	A factor used to calculate our Consumer Price Index. Multiply this factor by the prices and add the result to the overall sum to compute the Cost of Living Index.
rent_factor	A factor used to calculate our Rent Index. Multiply this factor by the prices and add the result to the overall sum to compute the Rent Index.

About In the News Newsletter API