Datasets

Search the Numbeo cities dataset

Searches the composite Numbeo cities dataset, merged from the current global rankings of all seven index families (cost of living, quality of life, crime, health care, pollution, traffic, property investment). A city appears once it is ranked by at least one family; coverage varies per city. Sort enum: name_asc, cost_of_living_asc, cost_of_living_desc, quality_of_life_desc, safety_desc, crime_asc, health_care_desc, pollution_asc, traffic_asc. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).

get/datasets/numbeo-cities/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/datasets/numbeo-cities/search
  • Auth: API key in header x-api-key

Query parameters

qstring

Full-text query over the city name, max 256 characters

countrystring

Exact country filter, max 128 characters

min_cost_of_living_indexnumber

Minimum Cost of Living Index (New York = 100)

max_cost_of_living_indexnumber

Maximum Cost of Living Index (New York = 100)

min_quality_of_life_indexnumber

Minimum Quality of Life Index

min_crime_indexnumber

Minimum Crime Index

max_crime_indexnumber

Maximum Crime Index

min_safety_indexnumber

Minimum Safety Index

min_health_care_indexnumber

Minimum Health Care Index

max_pollution_indexnumber

Maximum Pollution Index

max_traffic_indexnumber

Maximum Traffic Index

sort'name_asc' | 'cost_of_living_asc' | 'cost_of_living_desc' | 'quality_of_life_desc' | 'safety_desc' | 'crime_asc' | 'health_care_desc' | 'pollution_asc' | 'traffic_asc'

Sort enum: name_asc, cost_of_living_asc, cost_of_living_desc, quality_of_life_desc, safety_desc, crime_asc, health_care_desc, pollution_asc, traffic_asc

pageinteger

Page number, defaults to 1

page_sizeinteger

Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.