Numbeo Cost of Living Scraper

Extract itemized cost of living prices with min/max ranges by city from Numbeo, the world's largest crowd-sourced database of living costs. No login required — all data is publicly available.

Returns ~54 price items per city organized by category, including the actual price range (minimum and maximum reported values) for each item — not just the median.

---

What data does it extract?

Field	Type	Example
city	string	"Paris"
country	string	"France"
category	string	"Restaurants"
item	string	"Meal, 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"
checkedAt	string	"2026-04-23T18:00:00.000Z"

Categories covered

• Restaurants — Meals, coffee, beer, fast food
• Markets — Groceries: milk, bread, rice, eggs, produce, meat
• Transportation — Public transit, taxi, fuel, car prices
• Utilities — Electricity, internet, mobile plans
• Sports & Leisure — Gym, cinema, tennis court
• Childcare — Preschool, international school
• Clothing — Jeans, summer dress, shoes
• Rent — 1-bedroom and 3-bedroom apartments (city center and suburbs)
• Buy Apartment — Price per square meter
• Salaries & Financing — Average net salary, mortgage rate

---

How to use

1. Open the actor and click Try for free
2. Enter one or more city names (as they appear on Numbeo, e.g. New York, Paris, Buenos-Aires)
3. Select your preferred display currency (default: USD)
4. Click Start — results ready in ~5 seconds per city
5. Download as JSON or CSV from the dataset tab

---

Use cases

• Relocation research — Compare cost of living across multiple cities before moving
• Remote work analysis — Identify affordable cities for digital nomads
• Salary benchmarking — Understand purchasing power differences across markets
• Market entry research — Estimate operational costs (rent, salaries, utilities) before expanding to a new country
• Travel budgeting — Plan realistic travel budgets based on crowd-sourced real prices
• Academic research — Analyze price disparities across regions and countries

---

Input parameters

Parameter	Type	Default	Description
cities	array	required	List of city names to scrape (e.g. ["New York", "Paris", "Tokyo"])
currency	string	USD	Display currency code: USD, EUR, GBP, JPY, CLP, etc.
proxyConfiguration	object	Apify proxy	Proxy settings (datacenter proxies work for most cases)

City name format: Use the city name as it appears in Numbeo URLs. Spaces are automatically converted to hyphens. Examples: New York, Sao Paulo, Buenos-Aires.

---

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",
  "checkedAt": "2026-04-23T18:00:00.000Z"
}

---

Performance & limits

• Speed: ~3–5 seconds per city (lightweight CheerioCrawler, no browser)
• Items per city: ~54 price items across all categories
• Concurrency: 2 cities in parallel
• No browser required: Uses fast HTTP scraping — lower cost, lower memory
• Agent-ready: Compatible with x402 micropayment protocol for autonomous agent use

---

Pricing

This actor uses Pay Per Event (PPE) pricing: $0.005 per city scraped.

Cities	Estimated cost
10	~$0.05
100	~$0.50
500	~$2.50

The Apify free plan includes $5 monthly credit — enough for ~1,000 city lookups per month.

---

FAQ

What city name format should I use? Use city names as they appear on Numbeo. Spaces are auto-converted to hyphens. For ambiguous cities, use the format Numbeo uses in its URLs (e.g. New-York, Sao-Paulo).

Can I get data in my local currency? Yes. Set the currency parameter to any currency code Numbeo supports: USD, EUR, GBP, JPY, CLP, BRL, ARS, etc.

What's the difference between price, priceMin, and priceMax? price is the median reported by Numbeo users. priceMin and priceMax are the range boundaries from the crowd-sourced data — useful for budget planning with worst/best case scenarios.

Does it require login or API keys? No. All data on Numbeo's cost-of-living pages is publicly accessible without any credentials.

---

Related actors

• Financial Calendar Scraper — Earnings, IPOs, and economic events calendar.
• FinViz Stock Screener — Stock screener — gainers, losers, most active.
• MercadoLibre Scraper — Product listings and prices from MercadoLibre.
• Sodimac & Easy Scraper — Home improvement product prices from Sodimac and Easy.

---

Legal disclaimer

This actor extracts publicly available data from Numbeo (numbeo.com). All price data on Numbeo 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.0 — CheerioCrawler (no browser), country field, priceMin/priceMax ranges, PPE pricing