NUMBEO

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 browser due to 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/

Method: GET /api/cities

Description: Returns cities in the database. Omits cities for which there are no data.
Parameters:
Parameter nameDescriptionMandatory
api_keyYour API Keyyes
Example call:
/api/cities?api_key=your_api_key
Example response:
{  
   "cities":[  
      {  
         "city_id":6189,
         "longitude":20.4568089,
         "latitude":44.8178787,
         "country":"Serbia",
         "city":"Belgrade"
      },
      {  
         "city_id":3497,
         "longitude":-77.0363658,
         "latitude":38.8951118,
         "country":"United States",
         "city":"Washington, DC"
      },
      {  
         "city_id":3455,
         "longitude":-73.9865812,
         "latitude":40.7305991,
         "country":"United States",
         "city":"New York, NY"
      },
      {  
         "city_id":8142,
         "longitude":24.75404,
         "latitude":-28.72929,
         "country":"South Africa",
         "city":"Kimberley"
      }
   ]
}

Method: GET /api/price_items

Description: Returns items in our main cost of living section
Parameters:
Parameter nameDescriptionMandatory
api_keyYour API Keyyes
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 nameDescriptionMandatory
api_keyYour API Keyyes
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 nameDescriptionMandatory
api_keyYour API Keyyes
queryName or geolocation of the place for which result is requested. Internationalized or ambigous names are usually ok, names resolved with third party normative services.no
cityCity name (as in numbeo database)no
countryCountry name (as in numbeo database or ISO 3166 code)no
city_idInternal city id (as in numbeo database)no
currencyCurrency you want the data to be estimatedno
use_estimatedIf 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=Belgrade
Example response:
{
   "monthLastUpdate":4,
   "contributors":91,
   "name":"Belgrade, Serbia",
   "prices":[
      {
         "average_price":5.443478260869566,
         "item_name":"Meal, Inexpensive Restaurant, Restaurants",
         "highest_price":7,
         "item_id":1,
         "lowest_price":4
      },
      {
         "average_price":1.8523809523809522,
         "item_name":"Imported Beer (0.33 liter bottle), Restaurants",
         "highest_price":2.3,
         "item_id":5,
         "lowest_price":1.5
      },
      {
         "average_price":0.3611111111111111,
         "item_name":"Lettuce (1 head), Markets",
         "highest_price":0.5,
         "item_id":113,
         "lowest_price":0.25
      },
      {
         "average_price":1.3,
         "item_name":"Cappuccino (regular), Restaurants",
         "highest_price":1.5,
         "item_id":114,
         "lowest_price":1.2
      }
   ],
   "yearLastUpdate":2012,
   "currency":"EUR"
}

Method: GET /api/country_prices

Description: Returns current country prices
Parameters:
Parameter nameDescriptionMandatory
api_keyYour API Keyyes
countryCountry name (as in numbeo database or ISO 3166 code)no
currencyCurrency you want the data to be estimatedno
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
      },
      {
         "average_price":1.3874939824286925,
         "item_name":"Oranges (1kg), Markets",
         "highest_price":1.5,
         "item_id":111,
         "lowest_price":1.25
      },
      {
         "average_price":1.3975,
         "item_name":"Potato (1kg), Markets",
         "highest_price":1.79,
         "item_id":112,
         "lowest_price":0.8
      },
      {
         "average_price":2.0949999999999998,
         "item_name":"Lettuce (1 head), Markets",
         "highest_price":3.5,
         "item_id":113,
         "lowest_price":0.89
      },
      {
         "average_price":3.71844212292207,
         "item_name":"Cappuccino (regular), Restaurants",
         "highest_price":7,
         "item_id":114,
         "lowest_price":1.97376849168828
      }
   ],
   "yearLastUpdate":2012,
   "currency":"USD"
}

Method: GET /api/close_cities_with_prices

Description: Returns close cities for a given query (or coordinates) in our database.
Parameters:
Parameter nameDescriptionMandatory
api_keyYour API Keyyes
queryName or geolocation of the place for which result is requested. Internationalized or ambigous names are usually ok, names resolved with third party normative services.no
max_distanceMax distance in km to look up for cities (from the source location provided). Default: 200no
min_contributorsMinimum number of contributors for a city to be included in the response. Default: 10no
Example call:
/api/?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 nameDescriptionMandatory
api_keyYour API Keyyes
queryName or geolocation of the place for which result is requested. Internationalized or ambigous names are usually ok, names resolved with third party normative services.no
cityCity name (as in numbeo database)no
countryCountry name (as in numbeo database or ISO 3166 code)no
city_idInternal city id (as in numbeo database)no
currencyCurrency you want the data to be estimatedno
Example call:
/api/historical_city_prices?api_key=your_api_key&query=Belgrade
Example response:
{
  "entry":[
    {
      "amount":630.1988400994201,
      "item_id":1,
      "year":2010
    },
    {
      "amount":72.04184181510155,
      "item_id":8,
      "year":2013
    },
    {
      "amount":38.226592719593526,
      "item_id":13,
      "year":2014
    },
    {
      "amount":49.22682791144663,
      "item_id":13,
      "year":2015
    }
  ],
  "currency":"RSD",
  "city":"Belgrade, Serbia"
}

Method: GET /api/historical_country_prices

Description: Returns historical average prices (per year) in a country
Parameters:
Parameter nameDescriptionMandatory
api_keyYour API Keyyes
countryCountry name (as in numbeo database or ISO 3166 code)no
currencyCurrency you want the data to be estimatedno
Example call:
/api/historical_country_prices?api_key=your_api_key&country=Serbia
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":"RSD",
   "country":"Serbia"
}

Method: GET /api/historical_currency_exchange_rates

Description: Returns our historical exchange rates we are using (at the beginning of the month)
Parameters:
Parameter nameDescriptionMandatory
api_keyYour API Keyyes
monthMonthyes
yearYearyes
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
Parameters:
Parameter nameDescriptionMandatory
api_keyYour API Keyyes
queryName of the place for which result is requested. Internationalized or ambigous names are usually ok, names resolved with third party normative services.no
cityCity name (as in numbeo database)no
countryCountry name (as in numbeo database or ISO 3166 code)no
city_idInternal city id (as in numbeo database)no
currencyCurrency you want the data to be estimatedno
Example call:
/api/city_prices_raw?api_key=your_api_key&query=Belgrade
Example response:
{
   "entry":[
      {
         "amount":5,
         "amount_usd":6.534,
         "item_name":"Meal, Inexpensive Restaurant, Restaurants",
         "item_id":1,
         "month":4,
         "username_hash":"-128203102",
         "year":2012,
         "amount_eur":5,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":5,
         "amount_usd":6.6665,
         "item_name":"Meal, Inexpensive Restaurant, Restaurants",
         "item_id":1,
         "month":3,
         "username_hash":"311480788",
         "year":2012,
         "amount_eur":5,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":1.4,
         "amount_usd":1.98898,
         "item_name":"Taxi Start (Normal Tariff), Transportation",
         "item_id":107,
         "month":7,
         "username_hash":"1478288129",
         "year":2011,
         "amount_eur":1.4,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":0.7,
         "amount_usd":0.91476,
         "item_name":"Taxi 1km (Normal Tariff), Transportation",
         "item_id":108,
         "month":4,
         "username_hash":"-128203102",
         "year":2012,
         "amount_eur":0.7,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":1.2,
         "amount_usd":1.56684,
         "item_name":"Taxi 1km (Normal Tariff), Transportation",
         "item_id":108,
         "month":3,
         "username_hash":"-1123342682",
         "year":2012,
         "amount_eur":1.2,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":0.68,
         "amount_usd":0.96288,
         "item_name":"Taxi 1km (Normal Tariff), Transportation",
         "item_id":108,
         "month":10,
         "username_hash":"-2049386441",
         "year":2011,
         "amount_eur":0.68,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":0.65,
         "amount_usd":0.920075,
         "item_name":"Taxi 1km (Normal Tariff), Transportation",
         "item_id":108,
         "month":8,
         "username_hash":"-679754687",
         "year":2011,
         "amount_eur":0.65,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":0.55,
         "amount_usd":0.781385000000001,
         "item_name":"Taxi 1km (Normal Tariff), Transportation",
         "item_id":108,
         "month":7,
         "username_hash":"1478288129",
         "year":2011,
         "amount_eur":0.55,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":9,
         "amount_usd":11.9178,
         "item_name":"Taxi 1hour Waiting (Normal Tariff), Transportation",
         "item_id":109,
         "month":3,
         "username_hash":"-300050404",
         "year":2012,
         "amount_eur":9,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":8,
         "amount_usd":10.7296,
         "item_name":"Taxi 1hour Waiting (Normal Tariff), Transportation",
         "item_id":109,
         "month":2,
         "username_hash":"-996816023",
         "year":2012,
         "amount_eur":8,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":8,
         "amount_usd":10.7296,
         "item_name":"Taxi 1hour Waiting (Normal Tariff), Transportation",
         "item_id":109,
         "month":2,
         "username_hash":"-996816023",
         "year":2012,
         "amount_eur":8,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":5,
         "amount_usd":6.364,
         "item_name":"Taxi 1hour Waiting (Normal Tariff), Transportation",
         "item_id":109,
         "month":1,
         "username_hash":"-1077665570",
         "year":2012,
         "amount_eur":5,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":7.5,
         "amount_usd":10.65525,
         "item_name":"Taxi 1hour Waiting (Normal Tariff), Transportation",
         "item_id":109,
         "month":7,
         "username_hash":"1478288129",
         "year":2011,
         "amount_eur":7.5,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":1,
         "amount_usd":1.315,
         "item_name":"Oranges (1kg), Markets",
         "item_id":111,
         "month":3,
         "username_hash":"-1654662663",
         "year":2012,
         "amount_eur":1,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":1,
         "amount_usd":1.3057,
         "item_name":"Oranges (1kg), Markets",
         "item_id":111,
         "month":3,
         "username_hash":"-1123342682",
         "year":2012,
         "amount_eur":1,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":1,
         "amount_usd":1.3191,
         "item_name":"Oranges (1kg), Markets",
         "item_id":111,
         "month":3,
         "username_hash":"-1766981798",
         "year":2012,
         "amount_eur":1,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":1,
         "amount_usd":1.3388,
         "item_name":"Oranges (1kg), Markets",
         "item_id":111,
         "month":2,
         "username_hash":"1876888542",
         "year":2012,
         "amount_eur":1,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":0.9,
         "amount_usd":1.20708,
         "item_name":"Oranges (1kg), Markets",
         "item_id":111,
         "month":2,
         "username_hash":"-996816023",
         "year":2012,
         "amount_eur":0.9,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":0.8,
         "amount_usd":1.07296,
         "item_name":"Oranges (1kg), Markets",
         "item_id":111,
         "month":2,
         "username_hash":"1489371003",
         "year":2012,
         "amount_eur":0.8,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":1,
         "amount_usd":1.2808,
         "item_name":"Oranges (1kg), Markets",
         "item_id":111,
         "month":1,
         "username_hash":"1876888542",
         "year":2012,
         "amount_eur":1,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      }
   ]
}

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 nameDescriptionMandatory
api_keyYour API Keyyes
queryName of the place for which result is requested. Internationalized or ambigous names are usually ok, names resolved with third party normative services.no
cityCity name (as in numbeo database)no
countryCountry name (as in numbeo database or ISO 3166 code)no
city_idInternal city id (as in numbeo database)no
currencyCurrency you want the data to be estimatedno
Example call:
/api/city_prices_archive_raw?api_key=your_api_key&query=Belgrade
Example response:
{
   "entry":[
      {
         "amount":5,
         "amount_usd":6.534,
         "item_name":"Meal, Inexpensive Restaurant, Restaurants",
         "item_id":1,
         "month":4,
         "username_hash":"-128203102",
         "year":2012,
         "amount_eur":5,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      },
      {
         "amount":5,
         "amount_usd":6.6665,
         "item_name":"Meal, Inexpensive Restaurant, Restaurants",
         "item_id":1,
         "month":3,
         "username_hash":"311480788",
         "year":2012,
         "amount_eur":5,
         "currency":"EUR",
         "city":"Belgrade, Serbia"
      }
   ]
}

Method: GET /api/indices

Description: Returns Numbeo's indices for a city. Location can be specified with a query containing name or latitude,longitude (with comma separator).
Parameters:
Parameter nameDescriptionMandatory
api_keyYour API Keyyes
queryName or geolocation of the place for which result is requested. Internationalized or ambigous names are usually ok, names resolved with third party normative services.no
cityCity name (as in numbeo database)no
countryCountry name (as in numbeo database or ISO 3166 code)no
city_idInternal city id (as in numbeo database)no
Example call:
/api/indices?api_key=your_api_key&query=Belgrade
Example response:
{
   "health_care_index":50.06172839506173,
   "crime_index":38.21801747014595,
   "traffic_time_index":26.666666666666664,
   "purchasing_power_incl_rent_index":40.12168845492055,
   "cpi_index":54.03955667194646,
   "pollution_index":57.01433623847417,
   "traffic_index":66.73884343652705,
   "quality_of_life_index":57.23822054840707,
   "cpi_and_rent_index":35.19777836239038,
   "groceries_index":42.26947260306218,
   "safety_index":61.78198252985405,
   "name":"Belgrade, Serbia",
   "rent_index":14.941072506714569,
   "traffic_co2_index":707.361111111111,
   "restaurant_price_index":45.41139043722476,
   "traffic_inefficiency_index":63.001434294260044,
   "property_price_to_income_ratio":19.047619047619047
}

Method: GET /api/country_indices

Description: Returns Numbeo's indices for a country. Location can be specified with a country name.
Parameters:
Parameter nameDescriptionMandatory
api_keyYour API Keyyes
countryCountry 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 nameDescriptionMandatory
api_keyYour API Keyyes
queryName or geolocation of the place for which result is requested. Internationalized or ambigous names are usually ok, names resolved with third party normative services.no
cityCity name (as in numbeo database)no
countryCountry name (as in numbeo database or ISO 3166 code)no
city_idInternal city id (as in numbeo database)no
Example call:
/api/city_crime?api_key=your_api_key&query=Belgrade
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,
   "city_id":6189,
   "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 */
   "name":"Belgrade, Serbia",
   "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 nameDescriptionMandatory
api_keyYour API Keyyes
queryName or geolocation of the place for which result is requested. Internationalized or ambigous names are usually ok, names resolved with third party normative services.no
cityCity name (as in numbeo database)no
countryCountry name (as in numbeo database or ISO 3166 code)no
city_idInternal city id (as in numbeo database)no
Example call:
/api/city_crime_raw?api_key=your_api_key&query=Belgrade
Example response:
{
   "city_id":6189,
   "name":"Belgrade, Serbia",
   "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 nameDescriptionMandatory
api_keyYour API Keyyes
queryName or geolocation of the place for which result is requested. Internationalized or ambigous names are usually ok, names resolved with third party normative services.no
cityCity name (as in numbeo database)no
countryCountry name (as in numbeo database or ISO 3166 code)no
city_idInternal city id (as in numbeo database)no
Example call:
/api/city_healthcare?api_key=your_api_key&query=Belgrade
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":"Belgrade, Serbia",
   "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 nameDescriptionMandatory
api_keyYour API Keyyes
queryName or geolocation of the place for which result is requested. Internationalized or ambigous names are usually ok, names resolved with third party normative services.no
cityCity name (as in numbeo database)no
countryCountry name (as in numbeo database or ISO 3166 code)no
city_idInternal city id (as in numbeo database)no
Example call:
/api/city_healthcare_raw?api_key=your_api_key&query=Belgrade
Example response:
{
   "city_id":6189,
   "name":"Belgrade, Serbia",
   "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 nameDescriptionMandatory
api_keyYour API Keyyes
queryName or geolocation of the place for which result is requested. Internationalized or ambigous names are usually ok, names resolved with third party normative services.no
cityCity name (as in numbeo database)no
countryCountry name (as in numbeo database or ISO 3166 code)no
city_idInternal city id (as in numbeo database)no
Example call:
/api/city_pollution?api_key=your_api_key&query=Belgrade
Example response:
{
   "contributors":35,
   "drinking_water_quality_accessibility":0.5333333333333333, /* -2 is a minimum value, +2 maximum value */
   "noise_and_light_pollution":-0.12903225806451613, /* -2 is a minimum value, +2 maximum value */
   "water_pollution":0, /* -2 is a minimum value, +2 maximum value */
   "pm2.5":34,
   "city_id":6189,
   "monthLastUpdate":1,
   "index_pollution":60.168200357299355,
   "garbage_disposal_satisfaction":-0.0967741935483871, /* -2 is a minimum value, +2 maximum value */
   "name":"Belgrade, Serbia",
   "clean_and_tidy":-0.3870967741935484, /* -2 is a minimum value, +2 maximum value */
   "pm10":51,
   "air_quality":-0.4, /* -2 is a minimum value, +2 maximum value */
   "comfortable_to_spend_time":0.2727272727272727, /* -2 is a minimum value, +2 maximum value */
   "green_and_parks_quality":0.6451612903225806, /* -2 is a minimum value, +2 maximum value */
   "yearLastUpdate":2015
}

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 nameDescriptionMandatory
api_keyYour API Keyyes
queryName or geolocation of the place for which result is requested. Internationalized or ambigous names are usually ok, names resolved with third party normative services.no
cityCity name (as in numbeo database)no
countryCountry name (as in numbeo database or ISO 3166 code)no
city_idInternal city id (as in numbeo database)no
Example call:
/api/city_pollution_raw?api_key=your_api_key&query=Belgrade
Example response:
{
   "city_id":6189,
   "name":"Belgrade, Serbia",
   "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":6189,
         "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":6189,
         "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 nameDescriptionMandatory
api_keyYour API Keyyes
queryName or geolocation of the place for which result is requested. Internationalized or ambigous names are usually ok, names resolved with third party normative services.no
cityCity name (as in numbeo database)no
countryCountry name (as in numbeo database or ISO 3166 code)no
city_idInternal city id (as in numbeo database)no
Example call:
/api/city_traffic?api_key=your_api_key&query=Belgrade
Example response:
{
   "index_traffic":106.87150492721928,
   "index_co2_emission":4141.052631578947,
   "index_time":27.842105263157894,
   "index_time_exp":44.94705492808318,
   "analyze using Bus":{
      "time_bike":0,
      "distance":9.2,
      "time_bus":19.4,
      "time_tram":0.0,
      "count":5,
      "time_waiting":5.8,
      "time_train":0,
      "time_driving":0,
      "time_walking":6.6,
      "time_motorbike":0,
      "time_other":0
   },
   "reportees":20,
   "analyze using Car":{
      "time_bike":0,
      "distance":9.916666666666666,
      "time_bus":0,
      "time_tram":0.0,
      "count":12,
      "time_waiting":0.8333333333333334,
      "time_train":0,
      "time_driving":23.333333333333332,
      "time_walking":1.4166666666666667,
      "time_motorbike":0,
      "time_other":0
   },
   "city_id":6189,
   "primary_means_percentage_map":{
      "Car":60,
      "Working from Home":5,
      "Train":5,
      "Bike":0,
      "Walking":5,
      "Bus":25,
      "Motorbike":0
   },
   "name":"Belgrade, Serbia",
   "index_inefficiency":63.5867822735009,
   "analyze using Walking":{
      "time_bike":0,
      "distance":2.5,
      "time_bus":0,
      "time_tram":0.0,
      "count":1,
      "time_waiting":0,
      "time_train":0,
      "time_driving":0,
      "time_walking":30,
      "time_motorbike":0,
      "time_other":0
   },
   "overall_average_analyze":{
      "time_bike":0,
      "distance":9.552631578947368,
      "time_bus":5.105263157894737,
      "time_tram":0.0,
      "count":20,
      "time_waiting":2.3684210526315788,
      "time_train":0.8421052631578947,
      "time_driving":14.736842105263158,
      "time_walking":4.7894736842105265,
      "time_motorbike":0,
      "time_other":0
   },
   "analyze using Train":{
      "time_bike":0,
      "distance":14,
      "time_bus":0,
      "count":1,
      "time_waiting":6,
      "time_train":16,
      "time_driving":0,
      "time_walking":11,
      "time_motorbike":0,
      "time_other":0
   }
}

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 nameDescriptionMandatory
api_keyYour API Keyyes
queryName or geolocation of the place for which result is requested. Internationalized or ambigous names are usually ok, names resolved with third party normative services.no
cityCity name (as in numbeo database)no
countryCountry name (as in numbeo database or ISO 3166 code)no
city_idInternal city id (as in numbeo database)no
Example call:
/api/city_traffic_raw?api_key=your_api_key&query=Belgrade
Example response:
{
   "index_traffic":106.87150492721928,
   "index_co2_emission":4141.052631578947,
   "index_time":27.842105263157894,
   "index_time_exp":44.94705492808318,
   "analyze using Bus":{
      "time_bike":0,
      "distance":9.2,
      "time_bus":19.4,
      "count":5,
      "time_waiting":5.8,
      "time_train":0,
      "time_driving":0,
      "time_walking":6.6,
      "time_motorbike":0,
      "time_other":0
   },
   "reportees":20,
   "analyze using Car":{
      "time_bike":0,
      "distance":9.916666666666666,
      "time_bus":0,
      "count":12,
      "time_waiting":0.8333333333333334,
      "time_train":0,
      "time_driving":23.333333333333332,
      "time_walking":1.4166666666666667,
      "time_motorbike":0,
      "time_other":0
   },
   "city_id":6189,
   "primary_means_percentage_map":{
      "Car":60,
      "Working from Home":5,
      "Train":5,
      "Bike":0,
      "Walking":5,
      "Bus":25,
      "Motorbike":0
   },
   "name":"Belgrade, Serbia",
   "index_inefficiency":63.5867822735009,
   "analyze using Walking":{
      "time_bike":0,
      "distance":2.5,
      "time_bus":0,
      "count":1,
      "time_waiting":0,
      "time_train":0,
      "time_driving":0,
      "time_walking":30,
      "time_motorbike":0,
      "time_other":0
   },
   "overall_average_analyze":{
      "time_bike":0,
      "distance":9.552631578947368,
      "time_bus":5.105263157894737,
      "count":20,
      "time_waiting":2.3684210526315788,
      "time_train":0.8421052631578947,
      "time_driving":14.736842105263158,
      "time_walking":4.7894736842105265,
      "time_motorbike":0,
      "time_other":0
   },
   "analyze using Train":{
      "time_bike":0,
      "distance":14,
      "time_bus":0,
      "count":1,
      "time_waiting":6,
      "time_train":16,
      "time_driving":0,
      "time_walking":11,
      "time_motorbike":0,
      "time_other":0
   }
}

Method: GET /api/country_crime

Description: Returns aggregate analysis about crime perception in a given country.
Parameters:
Parameter nameDescriptionMandatory
api_keyYour API Keyyes
countryCountry 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 nameDescriptionMandatory
api_keyYour API Keyyes
countryCountry 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 nameDescriptionMandatory
api_keyYour API Keyyes
countryCountry 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 nameDescriptionMandatory
api_keyYour API Keyyes
countryCountry 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/city_climate

Description: Returns data about climate in a city. Data are returned using metric measurement units. Location can be specified with a query containing name or latitude,longitude (with comma separator).
Parameters:
Parameter nameDescriptionMandatory
api_keyYour API Keyyes
queryName or geolocation of the place for which result is requested. Internationalized or ambigous names are usually ok, names resolved with third party normative services.no
cityCity name (as in numbeo database)no
countryCountry name (as in numbeo database or ISO 3166 code)no
city_idInternal city id (as in numbeo database)no
Example call:
/api/city_climate?api_key=your_api_key&query=Belgrade
Example response:
{
  "city_id":6189,
  "months":{
    "3":{
      "temp_high_max":28,
      "dewpoint_high_avg":4,
      "dewpoint_high_min":-9,
      "dewpoint_high_max":16,
      "climate_index":85.4444673508275,
      "temp_high_min":-5,
      "dewpoint_low_avg":-1,
      "temp_low_avg":3,
      "temp_high_avg":12,
      "dewpoint_low_max":10,
      "dewpoint_low_min":-16,
      "temp_low_min":-13,
      "temp_low_max":14
    },
    "2":{
      "temp_high_max":24,
      "dewpoint_high_avg":2,
      "dewpoint_high_min":-16,
      "dewpoint_high_max":11,
      "climate_index":64.71010819687592,
      "temp_high_min":-12,
      "dewpoint_low_avg":-3,
      "temp_low_avg":-1,
      "temp_high_avg":7,
      "dewpoint_low_max":7,
      "dewpoint_low_min":-27,
      "temp_low_min":-24,
      "temp_low_max":9
    }
  },
  "best_months_to_visit_text":"Best months to visit: March, April, May, June, July, August, September, October, November.",
  "climate_index":84.15796742608451,
  "name":"Belgrade, Serbia"
}