To access our API, if you want to use https connection please use URL prefix https://www.numbeo.com/api/
If you client doesn't support https you could 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 have questions or technical difficulties in using Numbeo API, contact us at api@numbeo.com
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
country | Country name (as in numbeo database or ISO 3166 code) | no |
{ "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 } ] }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
{ "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 } ] }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
{ "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" } ] }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
query | The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: 'London, United Kingdom' , 'New York, NY, United States' and '51.509865,-0.118092' . Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs. | no |
city | The name of the city (as in numbeo database, see /api/cities ) | no |
country | The name of the country, as listed in the Numbeo database, or in ISO 3166 code format. | no |
city_id | Internal city id (as in numbeo database) | no |
strict_matching | When using query parameter, setting this to false will resolve the query to the major city rather than the closest city, when possible. The default value is: true . | no |
currency | Currency you want the data to be estimated | no |
use_estimated | When set to false , the engine will not attempt to estimate values from nearby cities for locations with low data coverage. The default value is true . | no |
{ "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 }
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 |
{ "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" }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
query | The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: 'London, United Kingdom' , 'New York, NY, United States' and '51.509865,-0.118092' . Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs. | no |
city | The name of the city (as in numbeo database, see /api/cities ) | no |
country | The name of the country, as listed in the Numbeo database, or in ISO 3166 code format. | no |
city_id | Internal city id (as in numbeo database) | no |
strict_matching | When using query parameter, setting this to false will resolve the query to the major city rather than the closest city, when possible. The default value is: true . | 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 |
{ "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" } ] }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
query | The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: 'London, United Kingdom' , 'New York, NY, United States' and '51.509865,-0.118092' . Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs. | no |
max_distance | Max distance in km to look up for cities (from the source location provided). Default: 200 | no |
min_contributors | Minimum number of contributors for a city to be included in the response. Default: 10 | no |
{ "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 } ] }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
query | The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: 'London, United Kingdom' , 'New York, NY, United States' and '51.509865,-0.118092' . Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs. | no |
city | The name of the city (as in numbeo database, see /api/cities ) | no |
country | The name of the country, as listed in the Numbeo database, or in ISO 3166 code format. | no |
city_id | Internal city id (as in numbeo database) | no |
strict_matching | When using query parameter, setting this to false will resolve the query to the major city rather than the closest city, when possible. The default value is: true . | no |
currency | Currency you want the data to be estimated | no |
{ "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" }
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 |
{ "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" }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
month | Month | yes |
year | Year | yes |
{ "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" }, ] }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
query | The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: 'London, United Kingdom' , 'New York, NY, United States' and '51.509865,-0.118092' . Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs. | no |
city | The name of the city (as in numbeo database, see /api/cities ) | no |
country | The name of the country, as listed in the Numbeo database, or in ISO 3166 code format. | no |
city_id | Internal city id (as in numbeo database) | no |
strict_matching | When using query parameter, setting this to false will resolve the query to the major city rather than the closest city, when possible. The default value is: true . | 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 |
{ "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 } ] }
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 |
{ "log":[ { "log_id":290, "city_item_raw_internal_id":4666656 }, { "log_id":291, "city_item_raw_internal_id":4666657 } ] }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
query | The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: 'London, United Kingdom' , 'New York, NY, United States' and '51.509865,-0.118092' . Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs. | no |
city | The name of the city (as in numbeo database, see /api/cities ) | no |
country | The name of the country, as listed in the Numbeo database, or in ISO 3166 code format. | no |
city_id | Internal city id (as in numbeo database) | no |
strict_matching | When using query parameter, setting this to false will resolve the query to the major city rather than the closest city, when possible. The default value is: true . | no |
currency | Currency you want the data to be estimated | no |
{ "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 } ] }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
query | The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: 'London, United Kingdom' , 'New York, NY, United States' and '51.509865,-0.118092' . Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs. | no |
city | The name of the city (as in numbeo database, see /api/cities ) | no |
country | The name of the country, as listed in the Numbeo database, or in ISO 3166 code format. | no |
city_id | Internal city id (as in numbeo database) | no |
strict_matching | When using query parameter, setting this to false will resolve the query to the major city rather than the closest city, when possible. The default value is: true . | no |
{ "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 }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
country | Country name (as in numbeo database or ISO 3166 code) | no |
{ "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 }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
query | The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: 'London, United Kingdom' , 'New York, NY, United States' and '51.509865,-0.118092' . Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs. | no |
city | The name of the city (as in numbeo database, see /api/cities ) | no |
country | The name of the country, as listed in the Numbeo database, or in ISO 3166 code format. | no |
city_id | Internal city id (as in numbeo database) | no |
strict_matching | When using query parameter, setting this to false will resolve the query to the major city rather than the closest city, when possible. The default value is: true . | no |
{ "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 }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
query | The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: 'London, United Kingdom' , 'New York, NY, United States' and '51.509865,-0.118092' . Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs. | no |
city | The name of the city (as in numbeo database, see /api/cities ) | no |
country | The name of the country, as listed in the Numbeo database, or in ISO 3166 code format. | no |
city_id | Internal city id (as in numbeo database) | no |
strict_matching | When using query parameter, setting this to false will resolve the query to the major city rather than the closest city, when possible. The default value is: true . | no |
{ "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 } ] }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
query | The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: 'London, United Kingdom' , 'New York, NY, United States' and '51.509865,-0.118092' . Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs. | no |
city | The name of the city (as in numbeo database, see /api/cities ) | no |
country | The name of the country, as listed in the Numbeo database, or in ISO 3166 code format. | no |
city_id | Internal city id (as in numbeo database) | no |
strict_matching | When using query parameter, setting this to false will resolve the query to the major city rather than the closest city, when possible. The default value is: true . | no |
{ "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 }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
query | The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: 'London, United Kingdom' , 'New York, NY, United States' and '51.509865,-0.118092' . Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs. | no |
city | The name of the city (as in numbeo database, see /api/cities ) | no |
country | The name of the country, as listed in the Numbeo database, or in ISO 3166 code format. | no |
city_id | Internal city id (as in numbeo database) | no |
strict_matching | When using query parameter, setting this to false will resolve the query to the major city rather than the closest city, when possible. The default value is: true . | no |
{ "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 } ] }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
query | The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: 'London, United Kingdom' , 'New York, NY, United States' and '51.509865,-0.118092' . Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs. | no |
city | The name of the city (as in numbeo database, see /api/cities ) | no |
country | The name of the country, as listed in the Numbeo database, or in ISO 3166 code format. | no |
city_id | Internal city id (as in numbeo database) | no |
strict_matching | When using query parameter, setting this to false will resolve the query to the major city rather than the closest city, when possible. The default value is: true . | no |
{ "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 }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
query | The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: 'London, United Kingdom' , 'New York, NY, United States' and '51.509865,-0.118092' . Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs. | no |
city | The name of the city (as in numbeo database, see /api/cities ) | no |
country | The name of the country, as listed in the Numbeo database, or in ISO 3166 code format. | no |
city_id | Internal city id (as in numbeo database) | no |
strict_matching | When using query parameter, setting this to false will resolve the query to the major city rather than the closest city, when possible. The default value is: true . | no |
{ "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 } ] }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
query | The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: 'London, United Kingdom' , 'New York, NY, United States' and '51.509865,-0.118092' . Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs. | no |
city | The name of the city (as in numbeo database, see /api/cities ) | no |
country | The name of the country, as listed in the Numbeo database, or in ISO 3166 code format. | no |
city_id | Internal city id (as in numbeo database) | no |
strict_matching | When using query parameter, setting this to false will resolve the query to the major city rather than the closest city, when possible. The default value is: true . | no |
{ "analyze using Motorbike":{ "time_waiting":0, "time_driving":0, "time_tram":0, "time_other":0, "distance":10.0584, "time_bike":0, "time_train":0, "time_motorbike":35, "time_walking":0.75, "count":4, "time_bus":0 }, "analyze using Train/Metro":{ "time_waiting":6.01, "time_driving":0, "time_tram":0, "time_other":0.19, "distance":19.702807616, "time_bike":0, "time_train":36.67, "time_motorbike":0, "time_walking":11.88, "count":100, "time_bus":1.98 }, "overall_average_analyze":{ "time_waiting":3.33920704845815, "time_driving":4.709251101321586, "time_tram":0, "time_other":0.14977973568281938, "distance":14.430506699559471, "time_bike":3.356828193832599, "time_train":17.237885462555067, "time_motorbike":0.6299559471365639, "time_walking":10.317180616740089, "count":241, "time_bus":4.215859030837004 }, "analyze using Bus/Trolleybus":{ "time_waiting":5.238095238095238, "time_driving":0, "time_tram":0, "time_other":0, "distance":13.365933104761908, "time_bike":0, "time_train":1.1904761904761905, "time_motorbike":0, "time_walking":7.9523809523809526, "count":21, "time_bus":35.904761904761905 }, "index_co2_emission":1869.8414096916301, "analyze using Car":{ "time_waiting":0, "time_driving":44.5, "time_tram":0, "time_other":0, "distance":22.536361599999996, "time_bike":0, "time_train":0, "time_motorbike":0, "time_walking":1.125, "count":24, "time_bus":0 }, "primary_means_percentage_map":{ "Walking":19.246861924686193, "Tram/Streetcar":0, "Train/Metro":41.84100418410041, "Car":10.0418410041841, "Bus/Trolleybus":8.786610878661087, "Working from Home":5.857740585774058, "Bicycle":12.552301255230125, "Motorcycle":1.6736401673640167 }, "index_time_exp":3017.4860798350724, "index_time":43.95594713656387, "index_traffic":155.89160368069412, "name":"London, United Kingdom", "analyze using Bike":{ "time_waiting":0, "time_driving":0, "time_tram":0, "time_other":0.3, "distance":7.6608582400000005, "time_bike":25.4, "time_train":0, "time_motorbike":0, "time_walking":0.26666666666666666, "count":30, "time_bus":0 }, "index_inefficiency":189.4021258120608, "analyze using Walking":{ "time_waiting":1.0217391304347827, "time_driving":0.021739130434782608, "time_tram":0, "time_other":0.13043478260869565, "distance":4.604948660869566, "time_bike":0, "time_train":4.804347826086956, "time_motorbike":0.06521739130434782, "time_walking":20.630434782608695, "count":46, "time_bus":0.10869565217391304 }, "contributors":241, "city_id":6512 }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
query | The name of the place for which result is requested (preferably followed by the comma and the country name), or latitude and longitude of the city. For example: 'London, United Kingdom' , 'New York, NY, United States' and '51.509865,-0.118092' . Ambiguous or internationalized names are usually acceptable, as they are resolved through our internal geolocation service, which maps them to internal city IDs. | no |
city | The name of the city (as in numbeo database, see /api/cities ) | no |
country | The name of the country, as listed in the Numbeo database, or in ISO 3166 code format. | no |
city_id | Internal city id (as in numbeo database) | no |
strict_matching | When using query parameter, setting this to false will resolve the query to the major city rather than the closest city, when possible. The default value is: true . | no |
{ "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 }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
country | Country name (as in numbeo database or ISO 3166 code) | no |
{ "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 }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
country | Country name (as in numbeo database or ISO 3166 code) | no |
{ "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 }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
country | Country name (as in numbeo database or ISO 3166 code) | no |
{ "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 }
Parameter name | Description | Mandatory |
---|---|---|
api_key | Your API Key | yes |
country | Country name (as in numbeo database or ISO 3166 code) | no |
{ "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 } }
Parameter name | Description | Mandatory | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
api_key | Your API Key | yes | ||||||||||||
section | Section of the website for which rankings has been requested. Numerical value.
| yes |
[ { "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 } ]
Parameter name | Description | Mandatory | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
api_key | Your API Key | yes | ||||||||||||
section | Section of the website for which rankings has been requested. Numerical value.
| yes |
{ "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 } ] }
Parameter name | Description | Mandatory | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
api_key | Your API Key | yes | ||||||||||||
section | Section of the website for which rankings has been requested. Numerical value.
| yes |
{ "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 } ] }
contributors12months | The number of contributors who have submitted data in the past 12 months |
monthLastUpdate | The month when the data was last updated |
yearLastUpdate | The year of the last update |
contributors | The total number of contributors whose data was used in the calculations (as we use an adaptive archive policy) |
cpi_factor | A factor used to calculate our Consumer Price Index (multiply these factors with the prices and add to the overall sum to calculate Cost of Living Index) |
rent_factor | A factor used to calculate our Rent Index (multiply these factors with the prices and add to the overall sum to calculate Rent Index) |