Numbeo API Documentation

To access our API, if you want to use http connection please use URL prefix http://www.numbeo.com:8008/api/ (this might not work in a browser that uses HSTS while it should work in command line clients such as wget or curl). If you want to use secure https connection please use URL prefix https://www.numbeo.com/api/

If you have questions or technical difficulties in using Numbeo API, contact us at api@numbeo.com

Method: GET /api/cities

Description: Returns cities in the database. Omits cities for which there are no data.

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
country	Country name (as in numbeo database or ISO 3166 code)	no

Example call:

/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 items in our main cost of living section

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes

Example call:

/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 our current exchange rates we are using

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes

Example call:

/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 in a city. Location can be specified with a query containing name or latitude,longitude (with comma separator).

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
query	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. Examples: 'London, United Kingdom', 'New York, NY, United States' and '51.509865, -0.118092'. Internationalized or ambiguous names are usually ok as names are resolved with our internal geolocation service to internal city ids.	no
city	City name (as in numbeo database)	no
country	Country name (as in numbeo database or ISO 3166 code)	no
city_id	Internal city id (as in numbeo database)	no
currency	Currency you want the data to be estimated	no
use_estimated	If set to false, for cities with low data coverage, the engine will not try to estimate values from nearby cities (default: true)	no

Example call:

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

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 current country prices

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
country	Country name (as in numbeo database or ISO 3166 code)	no
currency	Currency you want the data to be estimated	no

Example call:

/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: Returns estimated cost of living for a person or family (in a given city). Location can be specified with a query containing name or latitude,longitude (with comma separator).

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
query	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. Examples: 'London, United Kingdom', 'New York, NY, United States' and '51.509865, -0.118092'. Internationalized or ambiguous names are usually ok as names are resolved with our internal geolocation service to internal city ids.	no
city	City name (as in numbeo database)	no
country	Country name (as in numbeo database or ISO 3166 code)	no
city_id	Internal city id (as in numbeo database)	no
currency	Currency you want the data to be estimated	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 call:

/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 close cities for a given query (or coordinates) in our database.

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
query	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. Examples: 'London, United Kingdom', 'New York, NY, United States' and '51.509865, -0.118092'. Internationalized or ambiguous names are usually ok as names are resolved with our internal geolocation service 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 call:

/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) in a city. Location can be specified with a query containing name or latitude,longitude (with comma separator).

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
query	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. Examples: 'London, United Kingdom', 'New York, NY, United States' and '51.509865, -0.118092'. Internationalized or ambiguous names are usually ok as names are resolved with our internal geolocation service to internal city ids.	no
city	City name (as in numbeo database)	no
country	Country name (as in numbeo database or ISO 3166 code)	no
city_id	Internal city id (as in numbeo database)	no
currency	Currency you want the data to be estimated	no

Example call:

/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) in a country

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
country	Country name (as in numbeo database or ISO 3166 code)	no
currency	Currency you want the data to be estimated	no

Example call:

/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_currency_exchange_rates

Description: Returns our historical exchange rates we are using (at the beginning of the month)

Parameters:

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

Example call:

/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: Raw recent data entries for a given city, specified by a query (location or lat,lng) or city and country. Some algorithms which detect spam are invoked every ten days. In between, some spam is not properly classified. So if you use this method, you should consider not to use the data from the last 10 days. See also call city_prices_raw_deletion_log

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
query	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. Examples: 'London, United Kingdom', 'New York, NY, United States' and '51.509865, -0.118092'. Internationalized or ambiguous names are usually ok as names are resolved with our internal geolocation service to internal city ids.	no
city	City name (as in numbeo database)	no
country	Country name (as in numbeo database or ISO 3166 code)	no
city_id	Internal city id (as in numbeo database)	no
since_internal_id	If present, the call will return only entries having internal_id greater or equal than the id provided. If you use this parameter, you should use city_prices_raw_deletion_log as well.	no

Example call:

/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 in city_prices_raw which are retroactively classified as spam and deleted from that table.

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 call:

/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: Raw archived data entries for a given city, specified by a query (location or lat,lng) or city and country. Our backend processes moves data periodically from the main table to the archive table and using this query you can access data from the archive table.

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
query	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. Examples: 'London, United Kingdom', 'New York, NY, United States' and '51.509865, -0.118092'. Internationalized or ambiguous names are usually ok as names are resolved with our internal geolocation service to internal city ids.	no
city	City name (as in numbeo database)	no
country	Country name (as in numbeo database or ISO 3166 code)	no
city_id	Internal city id (as in numbeo database)	no
currency	Currency you want the data to be estimated	no

Example call:

/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 indexes for a city. Location can be specified with a query containing name or latitude,longitude (with comma separator).

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
query	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. Examples: 'London, United Kingdom', 'New York, NY, United States' and '51.509865, -0.118092'. Internationalized or ambiguous names are usually ok as names are resolved with our internal geolocation service to internal city ids.	no
city	City name (as in numbeo database)	no
country	Country name (as in numbeo database or ISO 3166 code)	no
city_id	Internal city id (as in numbeo database)	no

Example call:

/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 indexes for a country. Location can be specified with a country name.

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
country	Country name (as in numbeo database or ISO 3166 code)	no

Example call:

/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 analysis about crime perception in a city. Location can be specified with a query containing name or latitude,longitude (with comma separator).

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
query	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. Examples: 'London, United Kingdom', 'New York, NY, United States' and '51.509865, -0.118092'. Internationalized or ambiguous names are usually ok as names are resolved with our internal geolocation service to internal city ids.	no
city	City name (as in numbeo database)	no
country	Country name (as in numbeo database or ISO 3166 code)	no
city_id	Internal city id (as in numbeo database)	no

Example call:

/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 inputs about crime perceptions in a city. Location can be specified with a query containing name or latitude,longitude (with comma separator).

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
query	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. Examples: 'London, United Kingdom', 'New York, NY, United States' and '51.509865, -0.118092'. Internationalized or ambiguous names are usually ok as names are resolved with our internal geolocation service to internal city ids.	no
city	City name (as in numbeo database)	no
country	Country name (as in numbeo database or ISO 3166 code)	no
city_id	Internal city id (as in numbeo database)	no

Example call:

/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 inputs about healthcare quality perception in a city. Location can be specified with a query containing name or latitude,longitude (with comma separator).

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
query	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. Examples: 'London, United Kingdom', 'New York, NY, United States' and '51.509865, -0.118092'. Internationalized or ambiguous names are usually ok as names are resolved with our internal geolocation service to internal city ids.	no
city	City name (as in numbeo database)	no
country	Country name (as in numbeo database or ISO 3166 code)	no
city_id	Internal city id (as in numbeo database)	no

Example call:

/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 inputs about healthcare quality perception in a city. Location can be specified with a query containing name or latitude,longitude (with comma separator).

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
query	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. Examples: 'London, United Kingdom', 'New York, NY, United States' and '51.509865, -0.118092'. Internationalized or ambiguous names are usually ok as names are resolved with our internal geolocation service to internal city ids.	no
city	City name (as in numbeo database)	no
country	Country name (as in numbeo database or ISO 3166 code)	no
city_id	Internal city id (as in numbeo database)	no

Example call:

/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 perceptions about pollution in a city. Location can be specified with a query containing name or latitude,longitude (with comma separator).

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
query	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. Examples: 'London, United Kingdom', 'New York, NY, United States' and '51.509865, -0.118092'. Internationalized or ambiguous names are usually ok as names are resolved with our internal geolocation service to internal city ids.	no
city	City name (as in numbeo database)	no
country	Country name (as in numbeo database or ISO 3166 code)	no
city_id	Internal city id (as in numbeo database)	no

Example call:

/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 inputs about pollution perception in a city. Location can be specified with a query containing name or latitude,longitude (with comma separator).

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
query	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. Examples: 'London, United Kingdom', 'New York, NY, United States' and '51.509865, -0.118092'. Internationalized or ambiguous names are usually ok as names are resolved with our internal geolocation service to internal city ids.	no
city	City name (as in numbeo database)	no
country	Country name (as in numbeo database or ISO 3166 code)	no
city_id	Internal city id (as in numbeo database)	no

Example call:

/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 analysis of daily commute times (traffic) in a city. Location can be specified with a query containing name or latitude,longitude (with comma separator).

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
query	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. Examples: 'London, United Kingdom', 'New York, NY, United States' and '51.509865, -0.118092'. Internationalized or ambiguous names are usually ok as names are resolved with our internal geolocation service to internal city ids.	no
city	City name (as in numbeo database)	no
country	Country name (as in numbeo database or ISO 3166 code)	no
city_id	Internal city id (as in numbeo database)	no

Example call:

/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,
      "Bike":12.552301255230125,
      "Motorbike":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 entries about daily commute times (traffic) in a city. Location can be specified with a query containing name or latitude,longitude (with comma separator).

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
query	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. Examples: 'London, United Kingdom', 'New York, NY, United States' and '51.509865, -0.118092'. Internationalized or ambiguous names are usually ok as names are resolved with our internal geolocation service to internal city ids.	no
city	City name (as in numbeo database)	no
country	Country name (as in numbeo database or ISO 3166 code)	no
city_id	Internal city id (as in numbeo database)	no

Example call:

/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 analysis about crime perception in a given country.

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
country	Country name (as in numbeo database or ISO 3166 code)	no

Example call:

/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 analysis about health care quality perception in a given country.

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
country	Country name (as in numbeo database or ISO 3166 code)	no

Example call:

/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 analysis about pollution perceptions in a given country.

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
country	Country name (as in numbeo database or ISO 3166 code)	no

Example call:

/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 analysis about traffic perceptions in a given country.

Parameters:

Parameter name	Description	Mandatory
api_key	Your API Key	yes
country	Country name (as in numbeo database or ISO 3166 code)	no

Example call:

/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 by city for a given section at the website (i.e. cost of living, property, crime). It includes most important cities. It's updated continously.

Parameters:

Parameter name

Description

Mandatory

api_key

Your API Key

yes

section

Section of the website for which rankings has been requested. 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 call:

/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 given section at the website (i.e. cost of living, property, crime).

Parameters:

Parameter name

Description

Mandatory

api_key

Your API Key

yes

section

Section of the website for which rankings has been requested. 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 call:

/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 given section at the website (i.e. cost of living, property, crime).

Parameters:

Parameter name

Description

Mandatory

api_key

Your API Key

yes

section

Section of the website for which rankings has been requested. 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 call:

/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 in the past 12 months
monthLastUpdate	the month of the last update
yearLastUpdate	year of the last update
contributors	the overall number of contributors used to calculate these data (as we have an adaptive archive policy)
cpi_factor	used to calculate our Consumer Price Index (multiply these factors with the prices and add to the overall sum to calculate)
rent_factor	used to calculate our Rent Index (multiply these factors with the prices and add to the overall sum to calculate)

About In the News Newsletter API