{ "openapi": "3.0.1", "info": { "title": "Business license leads scraper (US and Canada)", "description": "Build local B2B lead lists from official city, county and state business license registers across 18 US and Canadian jurisdictions. Business name, trade name, licence type, activity, address, phone and issue date. Public open data, no API key.", "version": "0.0", "x-build-id": "sgF5jHGnLEktaYS9f" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mangudai~business-license-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mangudai-business-license-leads-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/mangudai~business-license-leads-scraper/runs": { "post": { "operationId": "runs-sync-mangudai-business-license-leads-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/mangudai~business-license-leads-scraper/run-sync": { "post": { "operationId": "run-sync-mangudai-business-license-leads-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": { "sources": { "title": "Jurisdictions", "type": "array", "description": "Official open data portals to pull from. Each one is a government business licence or business tax register.", "items": { "type": "string", "enum": [ "chicago", "new-york-city", "seattle", "los-angeles", "san-francisco", "new-orleans", "denver", "kansas-city-mo", "berkeley-ca", "marin-county-ca", "norfolk-va", "providence-ri", "gainesville-fl", "everett-wa", "delaware", "calgary", "edmonton", "winnipeg" ], "enumTitles": [ "Chicago, IL", "New York City, NY", "Seattle, WA", "Los Angeles, CA", "San Francisco, CA", "New Orleans, LA", "Denver, CO", "Kansas City, MO", "Berkeley, CA", "Marin County, CA", "Norfolk, VA", "Providence, RI", "Gainesville, FL", "Everett, WA", "Delaware (statewide)", "Calgary, AB", "Edmonton, AB", "Winnipeg, MB" ] }, "default": [ "chicago", "new-york-city", "seattle", "los-angeles", "san-francisco" ] }, "searchTerm": { "title": "Keyword filter", "type": "string", "description": "Full text search across every column of the source register. Use it for a trade or licence type, for example restaurant, salon, roofing, daycare, contractor, cannabis, tobacco, or for a company name." }, "issuedSince": { "title": "Issued on or after (YYYY-MM-DD)", "type": "string", "description": "Keep only licences issued on or after this date. Set it to the last 30 days to get newly licensed businesses, which are the strongest leads. Registers without an issue date column ignore this filter." }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of business records to return across every selected jurisdiction.", "default": 200 }, "maxItemsPerSource": { "title": "Max results per jurisdiction", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Optional per-jurisdiction cap. Leave empty to split the max results evenly across the jurisdictions you picked." }, "sortNewestFirst": { "title": "Newest licences first", "type": "boolean", "description": "Sort each register by issue date, newest first, and skip records with a blank or future-dated issue date. Turn this off to read a register in its natural order.", "default": true }, "includeRawRecord": { "title": "Include the raw source record", "type": "boolean", "description": "Add a raw field to every row holding the untouched record from the source portal, including columns this Actor does not map.", "default": false } } }, "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 } } } } } } } } } }