Numbeo Cost of Living Scraper

Extract itemized cost of living prices with min/max ranges by city or by country from Numbeo, the world's largest crowd-sourced database of living costs — plus, optionally, a monthly budget summary and indices; the price of one item in every city or country (e.g. a cappuccino in ~590 cities); and complete city and country rankings (cost of living, quality of life, crime, health care, pollution, traffic, property investment), current or historical back to 2009, worldwide or by region. No login or API key required.

---

What data does it extract?

Prices by city (default)

~55 price items per city, organized by category, each with the typical price and the reported range.

Field	Type	Example
city	string	"Paris"
country	string	"France"
category	string	"Restaurants"
item	string	"Meal at an Inexpensive Restaurant"
price	number	13.73
priceMin	number	10.84
priceMax	number	21.65
currency	string	"USD"
url	string	"https://www.numbeo.com/cost-of-living/in/Paris?displayCurrency=USD"
sourceUpdatedAt	string	"24 October 2026" — when Numbeo last updated the city
checkedAt	string	"2026-10-26T18:00:00.000Z" — when the run read it

Categories covered: Restaurants · Markets (groceries) · Transportation · Utilities · Sports And Leisure · Childcare · Clothing And Shoes · Rent Per Month · Buy Apartment Price · Salaries And Financing.

City summary (optional — includeCitySummary)

One extra row per city (type: "summary", category: "Summary"), placed before that city's prices:

Field	Example (London)
familyOfFourMonthlyCost	5085.5 — estimated monthly costs for a family of four, excluding rent
singlePersonMonthlyCost	1444.6 — same for a single person
costVsNewYorkPercent	-13 — negative = cheaper than New York (excluding rent)
rentVsNewYorkPercent	-34.8 — rent compared with New York
costOfLivingIndex, rentIndex, costOfLivingPlusRentIndex, groceriesIndex, restaurantPriceIndex, localPurchasingPowerIndex	87, 65.2, 76.9, 70.1, 90.8, 132.6
qualityOfLifeIndex, safetyIndex, healthCareIndex, pollutionIndex, trafficCommuteTimeIndex, climateIndex, propertyPriceToIncomeRatio	153.4, 45.0, 69.4, 57.7, 44.7, 88.3, 12.3
crimeIndex	55.0

Indices are only present for cities that appear in Numbeo's rankings; otherwise they are null.

Rankings (optional — mode: "rankings")

Complete ranking tables, one row per city (or country), with every index the table shows:

Ranking	Rows	Indices
cost-of-living	~580 cities	Cost of Living, Rent, Cost of Living Plus Rent, Groceries, Restaurant Price, Local Purchasing Power
quality-of-life	~300 cities	Quality of Life, Purchasing Power, Safety, Health Care, Cost of Living, Property Price to Income, Traffic Commute Time, Pollution, Climate
crime	~400 cities	Crime, Safety
health-care	~320 cities	Health Care, Health Care Exp.
pollution	~350 cities	Pollution, Exp. Pollution
traffic	~350 cities	Traffic, Time (minutes), Time Exp., Inefficiency, CO2 Emission
property-investment	~430 cities	Price to Income, Gross Rental Yield (centre / outside), Price to Rent (centre / outside), Mortgage as % of Income, Affordability
cost-of-living-by-country	~150 countries	Same indices as cost-of-living, by country

Each row has type: "ranking", ranking, rankingTitle, period, region, rank, city (null for countries), country, the indices as camelCase fields (e.g. qualityOfLifeIndex, grossRentalYieldCityCentre), url and checkedAt.

Historical and regional rankings: pick a Ranking period (current, or any edition from 2009 to today — start and mid-year) and a Region (Europe, Northern Europe, America, South America, Northern America, Asia, Eastern Asia, Africa, Oceania and more).

Prices by country (optional — mode: "countries")

The same ~55 itemized prices with ranges, for a whole country (city is null). With Summary row on, you also get the country's monthly costs for a family of four and a single person, and its cost-of-living indices.

One item in every city or country (optional — mode: "itemPrices")

The price of one item across all cities (~590) or countries (~100), sorted from most to least expensive — e.g. a cappuccino, a monthly transport pass, gasoline or a 1-bedroom apartment in the city centre.

Field	Example
type	"itemPrice"
item / itemCategory / itemId	"Cappuccino (Regular Size)" / "Restaurants" / 114
scope	"city" or "country"
rank	1 = most expensive
city, country	"Leuven", "Belgium"
price, currency	4.43, "USD"

Item names are matched flexibly ("cappuccino", "1 bedroom apartment city centre", "monthly transport pass"), or use Numbeo's numeric item ID.

---

How to use

1. Open the actor and click Try for free
2. Prices by city: enter one or more city names (e.g. New York, Paris, São Paulo, Sao Paulo, Brazil) and pick a display currency (default USD). Turn on City summary to add the monthly budget and indices row
3. Prices by country: set Mode to Prices by country and enter country names in English (e.g. Chile, Germany)
4. One item everywhere: set Mode to One item in every city or country, enter items (e.g. Cappuccino, Gasoline) and choose cities or countries
5. Rankings: set Mode to Rankings, choose one or more rankings, optionally a period (e.g. 2020) and a region (e.g. South America), and limit the rows (e.g. the top 50)
6. Click Start and download the results as JSON, CSV or Excel

---

Use cases

• Relocation research — Compare monthly budgets, rent and safety across cities before moving
• Remote work and digital nomads — Find affordable cities with good quality of life
• Salary benchmarking — Understand purchasing power differences across markets
• Market entry research — Estimate operating costs (rent, salaries, utilities) in a new country
• Real estate analysis — Compare rental yields and price-to-income ratios with the property ranking
• Travel budgeting — Plan realistic budgets from crowd-sourced prices
• Price indexes and journalism — Compare one product (coffee, beer, transport pass, rent) across 590 cities — a "Big Mac index" for anything
• Trend analysis — Follow how a city or country moved in the rankings since 2009
• Academic and policy research — Analyze price, crime, pollution and health care indices across regions

---

Input parameters

Parameter	Type	Default	Description
mode	string	cities	cities = prices by city; countries = prices by country; itemPrices = one item in every city or country; rankings = complete ranking tables
cities	array	—	City names (mode cities). Accents and the City, Country format are accepted
countries	array	—	Country names in English (mode countries)
items	array	—	Items (mode itemPrices): name as on Numbeo or item ID
itemScope	string	cities	cities or countries (mode itemPrices)
currency	string	USD	Display currency code: USD, EUR, GBP, JPY, CLP, BRL, etc.
includeCitySummary	boolean	false	Add one summary row per city or country: monthly budget, comparison with New York (cities) and indices
rankings	array	["cost-of-living"]	Rankings to extract (mode rankings) — see the table above
rankingPeriod	string	current	current or an edition: 2026-mid, 2026, 2025-mid … 2009
region	string	world	world or a region code: 150 Europe, 154 Northern Europe, 155 Western Europe, 039 Southern Europe, 151 Eastern Europe, 019 America, 021 Northern America, 005 South America, 013 Central America, 029 Caribbean, 142 Asia, 030 Eastern Asia, 035 South-Eastern Asia, 034 Southern Asia, 145 Western Asia, 143 Central Asia, 002 Africa, 015 Northern Africa, 009 Oceania, 053 Australia and New Zealand
maxRankingRows	integer	0	Rows per ranking or item table; 0 = the full table
proxyConfiguration	object	Apify proxy	Proxy settings (the default works)

---

Output format

{
  "city": "Paris",
  "country": "France",
  "category": "Restaurants",
  "item": "Meal at an Inexpensive Restaurant",
  "price": 13.73,
  "priceMin": 10.84,
  "priceMax": 21.65,
  "currency": "USD",
  "url": "https://www.numbeo.com/cost-of-living/in/Paris?displayCurrency=USD",
  "sourceUpdatedAt": "24 October 2026",
  "checkedAt": "2026-10-26T18:00:00.000Z"
}

---

Performance & limits

• Speed: about 20–30 seconds for 5 cities; all 8 rankings (~2,900 rows) in under 30 seconds; a single top-10 ranking in under 10 seconds; one item in ~100 countries in about 7 seconds; 6 items in about 15 seconds; a historical regional ranking in 10–20 seconds
• Items per city: ~55 price items (+1 summary row if enabled)
• Reliability: cities are retried automatically until the page loads; a city name Numbeo does not recognise is matched to Numbeo's own spelling when possible (accents, City, Country) and reported clearly in the log when it cannot be found
• No browser required: lightweight, low memory, low cost
• Agent-ready: Compatible with x402 micropayment protocol for autonomous agent use

---

Pricing

This actor uses Pay Per Event (PPE) pricing: $0.002 per result (each price item, summary row or ranking row is one result).

Request	Results	Estimated cost
1 city	~55	~$0.11
10 cities	~550	~$1.10
10 cities + city summary	~560	~$1.12
Top 50 of the quality-of-life ranking	50	~$0.10
Full cost-of-living ranking	~580	~$1.16

You can cap any run with the Max results limit — it stops exactly there and never charges for more.

---

FAQ

What city name format should I use? The plain city name usually works (New York, Paris, Tokyo). Accents (São Paulo) and the City, Country format (Sao Paulo, Brazil) are matched to Numbeo's own spelling automatically. Misspelled names cannot be guessed and are reported in the log.

Can I get data in my local currency? Yes. Set currency to any code Numbeo supports: USD, EUR, GBP, JPY, CLP, BRL, ARS, etc. Indices and rankings are relative scores and do not depend on currency.

What's the difference between price, priceMin, and priceMax? price is the typical value reported by Numbeo users. priceMin and priceMax are the range boundaries of the crowd-sourced data — useful for best/worst-case budgets.

How fresh is the data? Each price row carries sourceUpdatedAt, the date Numbeo last updated that city, and rankings carry rankingTitle (e.g. Current Quality of Life Index).

Does it require login or API keys? No. Everything comes from Numbeo's public pages.

---

Related actors

• FinViz Stock Screener — Stock screener with 60–94 fields per stock.
• Financial Calendar Scraper — Earnings, IPOs, and economic events calendar.
• Farmacias Chile Price Scraper — Pharmacy product prices in Chile.
• Sodimac & Easy Price Scraper — Home improvement product prices from Sodimac and Easy.

---

Keywords

numbeo scraper, cost of living data, cost of living by city, numbeo api alternative, quality of life index, crime index by city, numbeo rankings, rent prices by city, relocation data, digital nomad cost of living, salary benchmarking data, property price to income ratio

---

Legal disclaimer

This actor extracts publicly available data from Numbeo (numbeo.com). All data is publicly accessible without login or registration. Users are responsible for ensuring their use of the extracted data complies with applicable laws, Numbeo's terms of service, and any relevant regulations in their jurisdiction.

---

Changelog

• v1.2 (2026-10-27) — Prices by country, one item across every city or country, and historical and regional rankings. New mode Prices by country (~55 prices per country, optional summary with monthly costs and indices). New mode One item in every city or country — e.g. a cappuccino in ~590 cities or ~100 countries, with flexible item names. Rankings can now be limited to a region (Europe, South America, Asia…) and pulled for any past edition back to 2009; ranking rows include period and region. Existing inputs return exactly the same data as before.
• v1.1 (2026-10-26) — City summary, complete rankings, smarter city names and steadier runs. Optional summary row per city with monthly costs for a family of four and a single person (excluding rent), comparison with New York, and cost-of-living, quality-of-life, safety and crime indices. New Rankings mode with 8 complete tables: cost of living, quality of life, crime, health care, pollution, traffic, property investment and cost of living by country. City names with accents or in City, Country form are now matched automatically, and names that cannot be found are reported instead of silently returning nothing. Fewer cities missing on busy days. Existing inputs return exactly the same fields as before; nothing new is added or charged unless you turn it on.
• v1.0.x (2026-10-05) — Every row now carries its real category (previously "General"), cities no longer come back empty on busy days, and the new sourceUpdatedAt field shows when Numbeo last updated each city.
• v1.0 — Prices by city with country, priceMin/priceMax ranges, PPE pricing.