{ "openapi": "3.0.1", "info": { "title": "Business License Scraper - New Business Leads, 7 Markets", "description": "New business leads scraper for 7 US city & statewide registries. Export newly registered businesses with address, phone & email to CSV/JSON.", "version": "1.0", "x-build-id": "lsFA0K78C8cYEwix9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maydit~us-business-licenses-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maydit-us-business-licenses-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/maydit~us-business-licenses-scraper/runs": { "post": { "operationId": "runs-sync-maydit-us-business-licenses-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/maydit~us-business-licenses-scraper/run-sync": { "post": { "operationId": "run-sync-maydit-us-business-licenses-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": "Sources", "type": "array", "description": "Which cities/states to scrape. Connecticut and Colorado are STATEWIDE registries.", "items": { "type": "string", "enum": [ "chicago", "new_york", "san_francisco", "seattle", "los_angeles", "connecticut", "colorado" ], "enumTitles": [ "Chicago, IL (new licenses)", "New York, NY (new licenses)", "San Francisco, CA (registrations)", "Seattle, WA (license certificates)", "Los Angeles, CA (active businesses)", "Connecticut (statewide registry)", "Colorado (statewide registry)" ] }, "default": [ "chicago", "new_york", "san_francisco", "seattle", "los_angeles", "connecticut", "colorado" ] }, "registeredSince": { "title": "Registered since", "type": "string", "description": "Only businesses registered/licensed on or after this date (YYYY-MM-DD). THE key filter for fresh leads — e.g. last 30 days." }, "registeredUntil": { "title": "Registered until", "type": "string", "description": "Only businesses registered or licensed on or before this date (YYYY-MM-DD). Leave it empty to run right up to the present: Seattle, San Francisco, Los Angeles, Connecticut and Colorado are automatically capped at today because those registries publish future-dated rows, while Chicago and New York are left unbounded." }, "businessNameContains": { "title": "Business name contains", "type": "string", "description": "Only businesses whose legal or DBA name contains this text (case-insensitive). Leave empty for all." }, "industryContains": { "title": "Industry contains", "type": "string", "description": "Case-insensitive substring of the industry / license text, e.g. 'food'. That text is the license type in Chicago, New York and San Francisco, the NAICS description in Seattle and Los Angeles, and only an entity type in Connecticut ('LLC', 'Stock', 'Non-Stock') and Colorado (terse codes such as 'DLLC' or 'DPC'), so choose a needle that suits the sources you picked; leave empty for all." }, "maxResultsPerSource": { "title": "Max results per source", "minimum": 1, "type": "integer", "description": "Upper bound on records kept per source per run, newest first. It is per source rather than per run, so the default 500 across all 7 sources returns up to 3,500 records; raise it to backfill history (the actor stops fetching after 50,000 rows per source).", "default": 500 }, "maxRunSeconds": { "title": "Max run seconds", "minimum": 30, "type": "integer", "description": "Wall-clock budget for this run, in seconds. When it is reached the Actor stops cleanly and finishes successfully with the rows it already collected, instead of being killed mid-run. Sources are fetched one after another, up to 50 pages each; a source not reached in time is reported in the run SUMMARY. Raise it (and the run timeout in Run options) for a deliberately large job.", "default": 240 }, "socrataAppToken": { "title": "Socrata app token (optional)", "type": "string", "description": "Optional free Socrata app token for higher rate limits on scheduled runs." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }