{ "openapi": "3.0.1", "info": { "title": "YellowPages Canada Leads Scraper — Phone, Address, Website", "description": "Scrape Canadian business leads from YellowPages.ca by what + where: name, phone, full postal address with postcode, website, category, rating and geo. Every result page walked contiguously — 100% of a 1,749-result search returned. No login. Export JSON/CSV/Excel.", "version": "0.1", "x-build-id": "wt0uaSs5geMP8Q3oe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~yellowpages-canada-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-yellowpages-canada-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/scrapersdelight~yellowpages-canada-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-yellowpages-canada-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/scrapersdelight~yellowpages-canada-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-yellowpages-canada-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", "properties": { "what": { "title": "Business type / keyword (what)", "type": "string", "description": "What to search on YellowPages.ca — a business type, category or business name (the site's 'what' box). Examples: \"plumber\", \"restaurants\", \"dentists\", \"auto repair\", \"wedding planners\"." }, "where": { "title": "City / postal code (where)", "type": "string", "description": "Where to search (the site's 'where' box) — a Canadian city (\"Toronto\"), a city with its province (\"Toronto ON\", \"Vancouver BC\"), or a postal code (\"M5V 2T6\"). All three forms are verified working. An unrecognised location returns 0 results: the run still finishes successfully, charges nothing, and says so in its status message — it is not reported as a failed run." }, "maxItems": { "title": "Max leads", "minimum": 0, "type": "integer", "description": "Stop after this many leads (cost/speed guard). Set 0 for every result across all pages up to the safety cap.", "default": 100 }, "maxPages": { "title": "Max result pages", "minimum": 1, "type": "integer", "description": "How many search-result pages to walk (35 businesses per page). Raise it to go deeper — a busy city/category runs to 50+ pages, and the Actor stops by itself on the first page that renders no results.", "default": 3 }, "includeCompanyDetails": { "title": "Fetch business details (hours, geo, services, payment methods)", "type": "boolean", "description": "Open each business's YellowPages.ca page to add opening hours, exact geo coordinates, the full services list, payment methods, languages spoken and every category. Costs one extra request per lead. Leave it off for a fast name + phone + address + website run — those fields already come from the result page. NOTE: YellowPages.ca publishes no email addresses anywhere, so this does not add an email.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Default: Apify proxy (datacenter). Measured clean on YellowPages.ca — a contiguous 51-page walk returned 51/51 HTTP 200 through Apify datacenter IPs, and 33/33 on merchant detail pages. Switch to RESIDENTIAL, country CA only if you see repeated challenges.", "default": { "useApifyProxy": true } }, "requestConcurrency": { "title": "Request concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Max parallel requests while fetching business detail pages. Only matters when 'Fetch business details' is on.", "default": 5 } } }, "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 } } } } } } } } } }