{ "openapi": "3.0.1", "info": { "title": "Liquor License Openings: New Bars & Stores (US)", "description": "New US liquor licences from official state open data, in one schema: New York, Texas, Colorado, Missouri and Chicago. Filter by issue date, category (bar or restaurant, store, manufacturer, wholesaler), city, county and ZIP. Business data only. Leads for POS, distributors, insurers and suppliers.", "version": "1.0", "x-build-id": "J0MsZySbz161lfdSx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/offerastudio~liquor-license-openings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-offerastudio-liquor-license-openings", "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/offerastudio~liquor-license-openings/runs": { "post": { "operationId": "runs-sync-offerastudio-liquor-license-openings", "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/offerastudio~liquor-license-openings/run-sync": { "post": { "operationId": "run-sync-offerastudio-liquor-license-openings", "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": { "states": { "title": "States", "type": "array", "description": "Which states' official open data to read. Chicago stands for the City of Chicago's business licences (liquor classes) in Illinois.", "items": { "type": "string", "enum": [ "NY", "TX", "CO", "MO", "IL" ], "enumTitles": [ "New York (State Liquor Authority)", "Texas (Alcoholic Beverage Commission)", "Colorado (Liquor Enforcement Division)", "Missouri (Alcohol and Tobacco Control)", "Illinois: City of Chicago only" ] }, "default": [ "NY", "TX" ] }, "issuedSince": { "title": "Issued since", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "type": "string", "description": "Only licences whose original issue date is on or after this date, for example 2026-09-01 or a relative date like \"30 days\" (30 days ago). Default: the last 30 days. The datasets lag behind the agencies: Colorado is refreshed monthly, Texas by a few days, and Missouri lists only the newest weeks.", "default": "30 days" }, "categories": { "title": "Licence categories", "type": "array", "description": "The state licence types are mapped to these categories. Leave empty for the four business categories (everything except Other).", "items": { "type": "string", "enum": [ "on-premises", "off-premises", "manufacturer", "wholesaler", "other" ], "enumTitles": [ "On-premises: bar, restaurant, club, hotel", "Off-premises: liquor, grocery and convenience stores", "Manufacturer: brewery, winery, distillery", "Wholesaler, importer and distributor", "Other: temporary, event and delivery permits" ] }, "default": [ "on-premises", "off-premises", "manufacturer", "wholesaler" ] }, "cities": { "title": "Cities", "type": "array", "description": "Only licences at premises in these cities, for example Houston or Brooklyn. Case-insensitive. Leave empty for all.", "items": { "type": "string" } }, "counties": { "title": "Counties", "type": "array", "description": "Only licences in these counties, for example Harris or Kings. Colorado's dataset has no county, so a county filter returns nothing for CO.", "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes", "type": "array", "description": "Only licences whose premises ZIP code starts with one of these (a full ZIP such as 78701 or a prefix such as 787).", "items": { "type": "string" } }, "activeOnly": { "title": "Active licences only", "type": "boolean", "description": "Skip licences that the dataset marks as expired, cancelled or surrendered. New York's dataset and Colorado's list contain active licences only.", "default": true }, "maxResults": { "title": "Maximum licences", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many licences, newest first, spread evenly over the chosen states. Each licence returned costs $0.002.", "default": 100 } } }, "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 } } } } } } } } } }