{ "openapi": "3.0.1", "info": { "title": "Numbeo Cost of Living Scraper", "description": "Scrape cost of living prices, indices and city rankings from Numbeo. Extracts 55+ price items per city across 9 categories: food, rent, transport, utilities, salaries and more. Supports cities, countries and global rankings.", "version": "1.0", "x-build-id": "jsxFhOsSpAazCahsj" }, "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 exactly as it appears on Numbeo. For US cities include the state abbreviation, e.g. 'New York, NY', 'Los Angeles, CA'. International examples: 'Istanbul', 'London', 'Berlin', 'Tokyo'. 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 } } } } } } } } } }