# Numbeo Scraper (`crawlerbros/numbeo-scraper`) Actor Scrape Numbeo.com — the world's largest cost-of-living, quality-of-life, crime, healthcare, pollution, traffic, and property-price database. Get full price tables, index breakdowns, and city rankings for thousands of cities globally. - **URL**: https://apify.com/crawlerbros/numbeo-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Developer tools, Automation, Other - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 16 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Numbeo Scraper Scrape **Numbeo.com** — the world's largest crowd-sourced cost-of-living, quality-of-life, crime, healthcare, pollution, traffic, and property-price database — for any city worldwide. ### What you get Per-mode output: #### `costOfLiving` Full price table for a city: groceries, restaurants, transportation, utilities, sports & leisure, childcare, clothing, rent, salaries. ```jsonc { "city": "New York, NY, United States", "indices": { "Cost of Living Index": 100.0, ... }, "prices": [ {"item": "Meal at an Inexpensive Restaurant", "price": 25.0, "currency": "$", "rangeLow": 15.0, "rangeHigh": 45.0}, ... ], "nearbyCities": [{"city": "Jersey City, New Jersey", "distanceKm": 7.38}, ...] } ```` #### `qualityOfLife` Quality-of-life index breakdown plus component sub-indices (Purchasing Power, Safety, Health Care, Climate, Cost of Living, Property-Price-to-Income). #### `crime` / `healthCare` / `pollution` / `traffic` Each returns the city's index summary plus the labelled sub-rows ("Level of crime: 55.23 / Moderate", "Skill and competency of medical staff: 75.16 / High", etc.). The pollution mode also returns the WHO PM10 / PM2.5 panel. #### `propertyInvestment` Rent prices (1 / 3 bedroom apartments — city centre vs outside) plus the property index summary (Price-to-Income, Mortgage-as-Percentage-of-Income, Rent Yields, Affordability Index). #### `costOfLivingComparison` Side-by-side price comparison between two cities, with each row carrying both city prices and the percent difference. #### `topCities` Numbeo's annual city rankings — every city in the table with its Cost of Living, Rent, Cost of Living Plus Rent, Groceries, Restaurant, and Local Purchasing Power indices. Year selectable via `rankingsYear` (e.g., `2024`, `2024-mid`). #### `byUrl` Pass any Numbeo URL — the actor auto-routes to the right parser. ### Modes | Mode | URL pattern | |---|---| | `costOfLiving` | `/cost-of-living/in/` | | `costOfLivingComparison` | `/cost-of-living/compare_cities.jsp?...` | | `qualityOfLife` | `/quality-of-life/in/` | | `crime` | `/crime/in/` | | `healthCare` | `/health-care/in/` | | `pollution` | `/pollution/in/` | | `traffic` | `/traffic/in/` | | `propertyInvestment` | `/property-investment/in/` | | `topCities` | `/cost-of-living/rankings.jsp?title=2024` | | `byUrl` | any of the above | ### Example inputs #### Cost of living for New York ```json { "mode": "costOfLiving", "city": "New York", "maxItems": 1 } ``` #### Quality of life for multiple cities ```json { "mode": "qualityOfLife", "cities": ["Berlin", "Tokyo", "Lisbon", "Mexico City"], "maxItems": 4 } ``` #### Compare New York with Berlin ```json { "mode": "costOfLivingComparison", "country1": "United States", "city1": "New York, NY", "country2": "Germany", "city2": "Berlin" } ``` #### Top cities ranked by cost of living for 2024 ```json { "mode": "topCities", "rankingsYear": "2024", "maxItems": 100 } ``` #### Mixed URL list ```json { "mode": "byUrl", "urls": [ "https://www.numbeo.com/cost-of-living/in/Tokyo", "https://www.numbeo.com/crime/in/Sao-Paulo,Brazil", "https://www.numbeo.com/cost-of-living/rankings.jsp?title=2024" ], "maxItems": 10 } ``` ### City naming Numbeo uses single-segment hyphenated slugs in URLs. Globally unique cities use just the city name; ambiguous US cities append the two-letter state code with a hyphen: | Plain English | Numbeo slug | |---|---| | `New York` | `New-York` | | `Berlin` | `Berlin` | | `São Paulo` | `Sao-Paulo` | | `Tokyo` | `Tokyo` | | `Cambridge, MA` | `Cambridge-MA` | | `Birmingham, AL` | `Birmingham-AL` | | `Mexico City` | `Mexico-City` | Pass the plain-English form — the actor builds the slug for you and falls back through alternative slug forms automatically if the first guess returns "Cannot find city id". ### FAQ **Why are some price ranges missing?** Numbeo only shows the contributor-supplied range when there are enough samples. The actor omits `rangeLow` / `rangeHigh` rather than emitting `null`. **Are there separate currencies for non-US cities?** The price field is the value Numbeo displays for the page (typically the page's local currency or USD if the page is rendered in USD). The currency symbol is captured in the `currency` field when present. **How frequently does Numbeo update?** Numbeo is contributor-driven — popular cities update weekly, smaller cities monthly to quarterly. **Is the actor blocked by Numbeo's anti-bot?** Numbeo uses light bot detection. The actor uses curl\_cffi's Chrome 131 TLS impersonation, which is sufficient from Apify datacenter IPs in our testing. If you see 403s, enable `useProxy` or rely on `autoEscalateOnBlock` (the default). **Why are my numbers different from the website?** Numbeo recomputes indices on every contributor update — the dataset captures the values at scrape time. The page itself may show slightly different numbers a day later. **Can I get historical data?** Yes for rankings (`rankingsYear` accepts back-years from 2017 onward). Per-city pages always show the latest data only. ### Limitations - Comparison mode only supports two cities at a time (Numbeo's UI limitation). - The `topCities` rankings page shows ~370 cities by default — use `maxItems` to cap. - Numbeo's "indices" use US prices as the 100 baseline; lower numbers mean cheaper. ### Source Data is scraped from . Numbeo aggregates contributor surveys; review their [terms of use](https://www.numbeo.com/common/terms_of_use.jsp) before redistributing. # Actor input Schema ## `mode` (type: `string`): Which Numbeo section to scrape. ## `city` (type: `string`): City name in plain English. Examples: `New York`, `Berlin`, `Tokyo`, `São Paulo`, `Cambridge, MA`. The actor builds the Numbeo URL slug automatically and falls back through alternative slug forms (city-state, bare city) until Numbeo resolves the page. ## `cities` (type: `array`): Multiple city names — the actor will scrape each one in turn (combined with `city`). ## `country1` (type: `string`): Country of city 1 — full English name (e.g., `United States`). ## `city1` (type: `string`): First city in the comparison (e.g. `New York, NY`). ## `country2` (type: `string`): Country of city 2 — full English name (e.g., `Germany`). ## `city2` (type: `string`): Second city in the comparison (e.g. `Berlin`). ## `rankingsYear` (type: `string`): Year title parameter for the rankings page (e.g. `2024`, `2024-mid`). Leave empty for the latest available. ## `urls` (type: `array`): Direct Numbeo URLs. Examples: `https://www.numbeo.com/cost-of-living/in/Berlin`, `https://www.numbeo.com/quality-of-life/in/Tokyo`, `https://www.numbeo.com/cost-of-living/rankings.jsp?title=2024`. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## `useProxy` (type: `boolean`): Route HTTP requests through Apify proxy. Numbeo is generally accessible without a proxy from datacenter IPs; enable only if you see 403/429. ## `autoEscalateOnBlock` (type: `boolean`): If a 403/429/Cloudflare challenge appears on direct fetch, automatically retry through Apify proxy. ## `proxyConfiguration` (type: `object`): Apify proxy configuration. Used only when useProxy is enabled. ## Actor input object example ```json { "mode": "costOfLiving", "city": "New York", "cities": [], "country1": "United States", "country2": "Germany", "rankingsYear": "", "urls": [], "maxItems": 1, "useProxy": false, "autoEscalateOnBlock": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [] } } ``` # Actor output Schema ## `records` (type: `string`): Dataset containing all scraped Numbeo records. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "costOfLiving", "city": "New York", "cities": [], "urls": [], "maxItems": 1, "useProxy": false, "autoEscalateOnBlock": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [] } }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/numbeo-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "costOfLiving", "city": "New York", "cities": [], "urls": [], "maxItems": 1, "useProxy": False, "autoEscalateOnBlock": True, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": [], }, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/numbeo-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "costOfLiving", "city": "New York", "cities": [], "urls": [], "maxItems": 1, "useProxy": false, "autoEscalateOnBlock": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [] } }' | apify call crawlerbros/numbeo-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/numbeo-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Numbeo Scraper", "description": "Scrape Numbeo.com — the world's largest cost-of-living, quality-of-life, crime, healthcare, pollution, traffic, and property-price database. Get full price tables, index breakdowns, and city rankings for thousands of cities globally.", "version": "1.0", "x-build-id": "JNSMMkLDmIs5iHTrJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~numbeo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-numbeo-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~numbeo-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-numbeo-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~numbeo-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-numbeo-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "costOfLiving", "costOfLivingComparison", "qualityOfLife", "crime", "healthCare", "pollution", "traffic", "propertyInvestment", "topCities", "byUrl" ], "type": "string", "description": "Which Numbeo section to scrape.", "default": "costOfLiving" }, "city": { "title": "City", "type": "string", "description": "City name in plain English. Examples: `New York`, `Berlin`, `Tokyo`, `São Paulo`, `Cambridge, MA`. The actor builds the Numbeo URL slug automatically and falls back through alternative slug forms (city-state, bare city) until Numbeo resolves the page.", "default": "New York" }, "cities": { "title": "Cities (batch)", "type": "array", "description": "Multiple city names — the actor will scrape each one in turn (combined with `city`).", "default": [], "items": { "type": "string" } }, "country1": { "title": "Country 1 (comparison mode)", "enum": [ "", "United States", "United Kingdom", "Canada", "Australia", "Germany", "France", "Italy", "Spain", "Netherlands", "Belgium", "Switzerland", "Austria", "Sweden", "Norway", "Denmark", "Finland", "Ireland", "Portugal", "Greece", "Poland", "Czech Republic", "Hungary", "Romania", "Bulgaria", "Croatia", "Slovenia", "Slovakia", "Estonia", "Latvia", "Lithuania", "Iceland", "Luxembourg", "Malta", "Cyprus", "Russia", "Ukraine", "Turkey", "Israel", "United Arab Emirates", "Saudi Arabia", "Qatar", "Kuwait", "Bahrain", "Oman", "Egypt", "Morocco", "South Africa", "Nigeria", "Kenya", "Brazil", "Argentina", "Chile", "Colombia", "Peru", "Mexico", "China", "Japan", "South Korea", "Taiwan", "Hong Kong", "Singapore", "Malaysia", "Thailand", "Vietnam", "Indonesia", "Philippines", "India", "Pakistan", "Bangladesh", "New Zealand" ], "type": "string", "description": "Country of city 1 — full English name (e.g., `United States`).", "default": "United States" }, "city1": { "title": "City 1 (comparison mode)", "type": "string", "description": "First city in the comparison (e.g. `New York, NY`)." }, "country2": { "title": "Country 2 (comparison mode)", "enum": [ "", "United States", "United Kingdom", "Canada", "Australia", "Germany", "France", "Italy", "Spain", "Netherlands", "Belgium", "Switzerland", "Austria", "Sweden", "Norway", "Denmark", "Finland", "Ireland", "Portugal", "Greece", "Poland", "Czech Republic", "Hungary", "Romania", "Bulgaria", "Croatia", "Slovenia", "Slovakia", "Estonia", "Latvia", "Lithuania", "Iceland", "Luxembourg", "Malta", "Cyprus", "Russia", "Ukraine", "Turkey", "Israel", "United Arab Emirates", "Saudi Arabia", "Qatar", "Kuwait", "Bahrain", "Oman", "Egypt", "Morocco", "South Africa", "Nigeria", "Kenya", "Brazil", "Argentina", "Chile", "Colombia", "Peru", "Mexico", "China", "Japan", "South Korea", "Taiwan", "Hong Kong", "Singapore", "Malaysia", "Thailand", "Vietnam", "Indonesia", "Philippines", "India", "Pakistan", "Bangladesh", "New Zealand" ], "type": "string", "description": "Country of city 2 — full English name (e.g., `Germany`).", "default": "Germany" }, "city2": { "title": "City 2 (comparison mode)", "type": "string", "description": "Second city in the comparison (e.g. `Berlin`)." }, "rankingsYear": { "title": "Rankings year (topCities mode)", "enum": [ "", "2024", "2024-mid", "2023", "2023-mid", "2022", "2022-mid", "2021", "2021-mid", "2020", "2020-mid", "2019", "2018", "2017" ], "type": "string", "description": "Year title parameter for the rankings page (e.g. `2024`, `2024-mid`). Leave empty for the latest available.", "default": "" }, "urls": { "title": "URLs (byUrl mode)", "type": "array", "description": "Direct Numbeo URLs. Examples: `https://www.numbeo.com/cost-of-living/in/Berlin`, `https://www.numbeo.com/quality-of-life/in/Tokyo`, `https://www.numbeo.com/cost-of-living/rankings.jsp?title=2024`.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 5 }, "useProxy": { "title": "Use Apify proxy", "type": "boolean", "description": "Route HTTP requests through Apify proxy. Numbeo is generally accessible without a proxy from datacenter IPs; enable only if you see 403/429.", "default": false }, "autoEscalateOnBlock": { "title": "Auto-escalate to proxy on block", "type": "boolean", "description": "If a 403/429/Cloudflare challenge appears on direct fetch, automatically retry through Apify proxy.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy configuration. Used only when useProxy is enabled.", "default": { "useApifyProxy": true, "apifyProxyGroups": [] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```