{ "openapi": "3.0.1", "info": { "title": "Numbeo Scraper — Cost of Living Data by City", "description": "Numbeo API alternative: scrape cost of living prices, indices and city rankings without an API key. Export to CSV, JSON or Excel.", "version": "1.0", "x-build-id": "iEKm303RoeI0yKygV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~numbeo-cost-of-living-scrape/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-numbeo-cost-of-living-scrape", "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/logiover~numbeo-cost-of-living-scrape/runs": { "post": { "operationId": "runs-sync-logiover-numbeo-cost-of-living-scrape", "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/logiover~numbeo-cost-of-living-scrape/run-sync": { "post": { "operationId": "run-sync-logiover-numbeo-cost-of-living-scrape", "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", "properties": { "cities": { "title": "Cities", "type": "array", "description": "City names to scrape price data for. Use the city name as it appears on Numbeo, e.g. 'Istanbul', 'London', 'Berlin', 'Tokyo', 'New York', 'Los Angeles'. A state/country suffix after a comma (e.g. 'New York, NY') is accepted but ignored — only the city name is used. Each city generates one request per selected category.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Country names to scrape national average price data for. Returns the same 55+ price items as city mode but averaged across the entire country. Examples: 'Turkey', 'Germany', 'Japan', 'United States'. Use the English country name as shown on Numbeo.", "items": { "type": "string" } }, "scrapeRankings": { "title": "Scrape Global City Rankings", "type": "boolean", "description": "When enabled, scrapes the global city rankings table for each selected category. Returns indices such as Cost of Living Index, Rent Index, Purchasing Power Index, Safety Index etc. ranked across hundreds of cities worldwide.", "default": true }, "scrapeCategories": { "title": "Data Categories", "type": "array", "description": "Which Numbeo data categories to scrape for each city and country. 'cost-of-living' returns 55+ price items (food, rent, utilities, transport, salaries). Other categories return index scores and rankings. Multiple categories can be selected — each adds one request per city/country.", "items": { "type": "string", "enum": [ "cost-of-living", "quality-of-life", "crime", "health-care", "pollution", "traffic", "property-investment" ] } }, "maxCities": { "title": "Max Cities in Rankings", "minimum": 0, "type": "integer", "description": "Maximum number of cities to include from the global rankings pages. Numbeo rankings cover 500+ cities — set a lower value for faster runs or to limit dataset size. Set to 0 to include all available cities.", "default": 500 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for requests to Numbeo. Residential proxies are strongly recommended — Numbeo rate-limits datacenter IPs aggressively. Use 'RESIDENTIAL' proxy group for best results." } } }, "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 } } } } } } } } } }