{ "openapi": "3.0.1", "info": { "title": "Alberta Auto Business License Lookup - AMVIC Register", "description": "Scrape AMVIC's register of licensed Alberta automotive businesses - dealers, repair shops, body shops, recyclers and salvage. 8,297 active licences, 8,291 with an e-mail, every one with a renewal date, so you can target licences expiring in the next 30, 60 or 90 days. Phone, address and class too.", "version": "0.1", "x-build-id": "V9qTUaSrvBwvienaq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~amvic-alberta-auto-register-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-amvic-alberta-auto-register-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~amvic-alberta-auto-register-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-amvic-alberta-auto-register-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~amvic-alberta-auto-register-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-amvic-alberta-auto-register-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": { "licenceStatus": { "title": "Licence status", "type": "array", "description": "Measured counts: Issued 8,297 - Expired - Required to Reapply 5,200 - Closed - Voluntarily 4,469 - Expired 229 - Cancelled by Registrar 75. Defaults to currently-licensed businesses only.", "items": { "type": "string", "enum": [ "Issued", "Expired - Required to Reapply", "Closed - Voluntarily", "Expired", "Cancelled by Registrar" ] }, "default": [ "Issued" ] }, "province": { "title": "Province", "type": "array", "description": "Normalised before matching, so 'Alberta', 'ALBERTA' and 'AB' all count as AB. The register is 20,832 Alberta plus a small out-of-province tail (BC 40, ON 37, SK 7, MB 7).", "default": [ "AB" ], "items": { "type": "string" } }, "city": { "title": "City", "type": "array", "description": "Optional, case-insensitive. Largest active-licence cities: Calgary 2,179 - Edmonton 1,837 - Red Deer 206 - Lethbridge 174 - Grande Prairie 157.", "default": [], "items": { "type": "string" } }, "expiringWithinDays": { "title": "Only licences expiring within N days", "minimum": 0, "type": "integer", "description": "The renewal trigger. Measured against active licences: 401 expire within 30 days, 1,052 within 60, 1,665 within 90, 3,741 within 180. 0 disables the filter.", "default": 0 }, "requireEmail": { "title": "Only businesses with an e-mail address", "type": "boolean", "description": "8,291 of the 8,297 active licences carry one. Across the whole register including closed and expired records it is 82.6%.", "default": false }, "includeUnlicensed": { "title": "Include applications and refusals", "type": "boolean", "description": "Off by default. 3,667 register rows (16.7%) have no registration number and no status - these are applications and refusals rather than licensed businesses, and 230 of them name an individual with '(refused)' in the name field. Turn this on only if you specifically need them.", "default": false }, "includeBusinessClasses": { "title": "Look up licence classes", "type": "boolean", "description": "Adds the AMVIC licence classes each business holds (Used Sales, Retail Sales, Wholesale, Auto Body, Recycling and Dismantling, Leasing, and so on). Costs one extra request per delivered row and is never charged separately. Salespeople are deliberately not read.", "default": true }, "maxRecords": { "title": "Maximum licences to deliver", "minimum": 0, "type": "integer", "description": "Hard cap on delivered - and therefore charged - rows, applied after sorting by soonest expiry. 0 means every match. Default 1,000 so a first run cannot bill for the whole register by accident.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy, RESIDENTIAL with a Canadian exit. AMVIC sits behind AWS WAF: measured 2026-09-11, residential-CA passed 10 of 10 requests where datacenter passed 4 of 10.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "CA" } } } }, "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 } } } } } } } } } }