# US Tobacco, Vape & Smoke Shop Retailer Leads Scraper (`scrapesage/us-tobacco-vape-retailer-leads`) Actor Scrape US tobacco, vape & smoke-shop leads from official state & city license registries (TX, NY, NYC, PA, CO, MO): name, DBA, address, product types, vape/e-cig flag, distributor & wholesaler roles, license type, new-permit & expiration signals + lead score. Filter & monitor new licenses. - **URL**: https://apify.com/scrapesage/us-tobacco-vape-retailer-leads.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $5.00 / 1,000 tobacco / vape business records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## US Tobacco, Vape & Smoke Shop Retailer Leads Scraper — Official License Registries Extract **every licensed US tobacco, vape & smoke-shop business** from the official **state and city license registries** in one run — **retailers, vape / e-cigarette shops, distributors, wholesalers and manufacturers** across the whole supply chain. Each record comes back as a ready-to-use **B2B lead**: business name + DBA, full address, county, geo, **product types** (cigarette, vape / e-cigarette, other tobacco), **business role**, license type & number, **new-permit and license-expiration signals**, phone (where the source publishes it), and a derived **lead score**. Data comes straight from six official open-data sources — no login, no cookies, no browser, **no API key**: - **[Texas Comptroller — Cigarette/Tobacco permits](https://data.texas.gov/dataset/Active-Cigarette-Tobacco-Retailers/n4rp-ar9b)** (retailers, distributors & manufacturers; ~56k retailers incl. ~23k **e-cig** retailers) - **[New York Tax & Finance — Registered Retail Dealers + Wholesale dealers](https://data.ny.gov/Government-Finance/Registered-Retail-Dealers-of-Cigarettes-and-Tobacc/55xf-9jat)** (~21k retailers with a **CIG / VAPE flag**) - **[NYC DCWP — Other Tobacco Products & Wholesale Cigarette dealers](https://data.cityofnewyork.us/Business/Other-Tobacco-Products-License/f264-qcv3)** (carry a **phone number**) - **[Pennsylvania Revenue — Cigarette & Tobacco Products Tax Licenses](https://data.pa.gov/)** (~16.5k, with **license-expiration** dates) - **[Colorado Revenue — Tobacco Licenses](https://data.colorado.gov/)** (~4.9k) - **[Missouri Revenue — Cigarette & OTP Licensees](https://data.mo.gov/)** ### Why this tobacco & vape retailer scraper? Generic Google-Maps "smoke shop near me" scrapers grab a pin and a guessed e-mail and miss everything that lets you **segment, qualify and time** an outreach. This actor reads the official tax & licensing registries directly and ships the **richest dataset in the category** — firmographics **plus** the regulatory detail (product authorization, supply-chain role, license type, permit & expiration dates) in one clean table, across the full supply chain. | Data | Maps / email scrapers | This actor | |---|---|---| | Business name, full address, county, geo | partial | ✅ | | **Vape / e-cigarette flag** | ❌ | ✅ explicit (TX & NY) | | **Product types** (cigarette / vape / other tobacco) | ❌ | ✅ | | **Supply-chain role** (retailer / distributor / wholesaler / manufacturer / importer) | ❌ | ✅ | | License type & number | ❌ | ✅ | | **New-permit date** → newly-opened stores | ❌ | ✅ (TX, NYC) | | **License-expiration date** → renewal timing | ❌ | ✅ (PA) | | Phone | guessed | ✅ where published (NYC) | | DBA / trade name | ❌ | ✅ | | Derived **lead score + lead signals** | ❌ | ✅ | | Only-new / changed **monitoring mode** | ❌ | ✅ | ### Who buys tobacco & vape retailer data? - **Tobacco, vape & cigar distributors and brands** — find every authorized retailer to place product, segmented by **vape vs cigarette vs other tobacco** and by city/county. Disposable-vape and e-liquid brands can target the explicit **e-cig / vapor** retailers; cigar and smokeless brands can target OTP dealers. - **Distributors looking for retail accounts / brands looking for distributors** — the dataset spans the **whole supply chain**, so wholesalers can prospect retailers and brands can find licensed distributors, wholesalers and manufacturers. - **POS, age-verification & retail-tech vendors** — sell scan-data, ID-check, loyalty and POS systems to convenience stores, smoke shops and vape shops; reach **newly-permitted** stores the moment they open. - **Compliance, licensing & PMTA software** — target licensed tobacco & vapor businesses by state, role and product; reach licensees ahead of **renewal**. - **Insurance & financial services** — tobacco retailers and distributors are recurring accounts for business insurance, merchant services and working capital. - **Market & competitive intelligence** — track new licenses, count vape vs cigarette retailers by market, and map the full competitive field. ### How to use 1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor. 2. Open the **US Tobacco, Vape & Smoke Shop Retailer Leads Scraper**, pick **jurisdictions** (TX, NY, NYC, PA, CO, MO), optionally filter by **role**, **product type**, **vape-only**, city/county/ZIP, and choose your limit. 3. Click **Start** and watch records stream into the dataset table. 4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2). ### Input ```json { "states": ["TX", "NY"], "productTypes": ["vape"], "vapeOnly": true, "sortBy": "newest", "maxResults": 1000 } ```` - **states** — jurisdictions to scrape: `TX`, `NY`, `NYC`, `PA`, `CO`, `MO`. Leave empty for all. - **businessRoles** — keep only `retailer`, `distributor`, `wholesaler`, `manufacturer`, `importer`, `stamping_agent`, `vending`, `itinerant`, `delivery`. Leave empty for all. - **productTypes** — keep only `cigarette`, `vape` (e-cigarette / vapor), and/or `otp` (other tobacco — cigars, pipe, smokeless). - **vapeOnly** — keep only vape / e-cigarette retailers and vapor-product dealers (explicitly flagged in TX & NY). - **retailersOnly / distributorsOnly** — focus on storefronts, or on the supply chain (distributors, wholesalers, manufacturers, importers). - **cities / counties / zipCodes / nameQuery** — location and name/DBA filters. - **permittedAfter / newlyPermittedOnly** — newly-licensed stores (issue date, where published: TX, NYC). - **expiringBefore / expiringWithinDays / expiringSoonOnly** — renewal-timing leads (expiration date, where published: PA). - **withPhoneOnly / withGeoOnly / minLeadScore** — record filters. - **sortBy** — `leadScore` (default), `newest`, `expiringSoon`, `name`, `state`, or `source`. - **maxResults / maxResultsPerState / deduplicateResults / includeRawFields** — output controls. - **monitorMode / monitorKey** — only return businesses that are new or changed since the last run. - **socrataAppToken** — optional, only for very large scheduled pulls. - **proxyConfiguration** — optional; the sources are public and need no proxy, so leave it off for the fastest queries. ### Output By default you get **one clean, dense table** of tobacco & vapor businesses. A record: ```json { "recordType": "tobaccoBusiness", "source": "NYC DCWP — Other Tobacco Products Retail Dealer Licenses", "sourceState": "NYC", "stateName": "New York City (NYC)", "businessName": "1705 Sunshine Wholesale Inc", "dba": null, "businessRole": "retailer", "businessRoleLabel": "Retailer", "isRetailer": true, "isDistributor": false, "productTypes": ["otp"], "sellsCigarettes": false, "sellsVape": false, "sellsOtherTobacco": true, "isVapeRetailer": false, "licenseType": "Other Tobacco Products Retail Dealer", "licenseNumber": "OTP-10124", "status": "active", "street": "7804 20th Ave", "city": "Brooklyn", "state": "NY", "zip": "11214", "county": "Brooklyn", "fullAddress": "7804 20th Ave, Brooklyn, NY, 11214", "phone": "(718) 232-6968", "latitude": 40.609026, "longitude": -73.993668, "issueDate": "2026-05-28", "isNewlyPermitted": true, "expirationDate": null, "expiringWithinDays": null, "leadScore": 91, "leadSignals": ["Retailer", "Phone on file", "Newly permitted (2026-05-28)"], "sourceDataset": "data.cityofnewyork.us/f264-qcv3", "scrapedAt": "2026-06-21T12:00:00.000Z" } ``` A Texas e-cig retailer comes back with `businessRole: "retailer"`, `isVapeRetailer: true`, `productTypes: ["vape"]`, a county, and a permit date; a distributor or manufacturer carries `businessRole: "distributor"` / `"manufacturer"` with its product types. Every record also carries the raw source row under `sourceFields` unless you turn off **includeRawFields**. Switch the dataset view to **Leads**, **Vape & e-cig**, or **Distribution & supply chain** for a focused table. #### What to expect (field coverage) Each official source has its own strengths, so coverage varies by jurisdiction — and nothing is dropped, so you always get the richest record available. | Field group | Coverage | |---|---| | Business name, role, product types, address, license number | ✅ ~100% | | **Vape / e-cigarette flag** | ✅ explicit in TX (E-CIG retailer) and NY (VAPE) | | County | ✅ TX, PA, NYC (borough) | | Latitude / longitude | ✅ NY, NYC, PA | | **New-permit date** | ✅ TX, NYC | | **License-expiration date** | ✅ PA (forward-looking); CO publishes a periodic snapshot | | Phone | ✅ NYC DCWP records | | DBA / trade name | ✅ TX, NY wholesale, PA, CO, MO | A blank field means that source doesn't publish that signal for that record — not that scraping failed. We never fabricate contact data; everything in the record is straight from the official source. ### Automate & schedule Run this actor on autopilot and pull results into your own stack: - **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, and manage schedules over REST. - **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs. - **[Schedules](https://docs.apify.com/platform/schedules)** — run it weekly/monthly with **monitoring mode** to capture newly-licensed tobacco & vape stores as fresh leads (TX adds thousands of new permits a year). - **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, e-mail sequence) the moment a run finishes. ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' }); const run = await client.actor('scrapesage/us-tobacco-vape-retailer-leads').call({ states: ['TX', 'NY'], vapeOnly: true, sortBy: 'newest', }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} tobacco & vape businesses`); ``` ### Integrate with any app Connect the dataset to 5,000+ apps — no code required: - **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios. - **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new tobacco & vape leads straight into your CRM. - **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored state or city gets a new or changed licensee. - **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet. - **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse. - **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases. ### Use with AI assistants (MCP) The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find every newly-permitted vape retailer in Texas this quarter, with address and a lead score" and let it run the scraper for you. ### More scrapers from scrapesage Build a complete **regulated-retail & B2B lead-gen stack**: - **[US SNAP Retailer Leads Scraper](https://apify.com/scrapesage/snap-retailer-leads-scraper)** — every SNAP/EBT-authorized convenience store, grocery & supermarket. - **[US Restaurant Inspection Scraper](https://apify.com/scrapesage/us-restaurant-inspection-scraper)** — restaurants, grades, violations & new-opening signals. - **[US Cannabis License Scraper](https://apify.com/scrapesage/us-cannabis-license-scraper)** — licensed dispensaries, cultivators & processors. - **[US Firearms License Scraper](https://apify.com/scrapesage/us-firearms-license-scraper)** — federal firearms licensees (FFLs). - **[US Auto Dealer Scraper](https://apify.com/scrapesage/us-auto-dealer-scraper)** — licensed dealers, repair, salvage & tow from state registries. - **[Texas Business Leads Scraper](https://apify.com/scrapesage/texas-business-leads-scraper)** — active TX businesses by NAICS industry + new-business feed. - **[US Business Formation Scraper](https://apify.com/scrapesage/us-business-formation-scraper)** — newly-registered companies as fresh leads. - **[USDA FSIS Establishment Scraper](https://apify.com/scrapesage/fsis-establishment-scraper)** — meat, poultry & egg plants with contacts. ### Tips - **Vape distributors**: set `productTypes: ["vape"]` (or `vapeOnly: true`) and `states: ["TX","NY"]` for a clean list of e-cig / vapor retailers — the segment that's growing fastest. - **New-store feed**: set `sortBy: "newest"` (and optionally `newlyPermittedOnly: true`) to reach stores the moment they're permitted — the highest-converting moment for POS, distribution and merchant services. - **Renewal timing**: for PA, set `expiringWithinDays: 90` and sort by `expiringSoon` to reach licensees ahead of renewal. - **Find the supply chain**: set `distributorsOnly: true` to pull only distributors, wholesalers, manufacturers and importers — ideal for brands seeking placement partners. - **Recurring monitoring**: combine [Schedules](https://docs.apify.com/platform/schedules) with `monitorMode` to capture only businesses added or changed since the last run. ### FAQ **Where does the data come from?** From official US state and city tax & licensing registries published as open data: the Texas Comptroller, NY Department of Taxation & Finance, NYC Department of Consumer & Worker Protection (DCWP), Pennsylvania Department of Revenue, Colorado Department of Revenue, and Missouri Department of Revenue. **Does it need an API key or login?** No. Every source is public open data — no key, no login, no browser. An optional Socrata app token can raise rate limits on very large scheduled pulls, but it isn't required. **How fresh is it?** TX, NY, NYC, PA and MO are refreshed by the agencies on an ongoing basis (TX and PA within days). Colorado publishes a periodic snapshot, so its license-expiration dates are point-in-time — the businesses are real and stable, but treat the CO expiration field as the last license term on record rather than a live renewal date. Run on a [Schedule](https://docs.apify.com/platform/schedules) with monitoring mode to capture new licenses as they appear. **What's the difference between a retailer, distributor and wholesaler?** A **retailer** sells tobacco/vapor products to consumers; a **distributor / wholesaler** supplies retailers; a **manufacturer / importer** makes or imports product; a **stamping agent** applies cigarette tax stamps. The actor normalizes each source's license types into one `businessRole` so you can filter the whole supply chain consistently. **Does it include vape / e-cigarette shops?** Yes. Texas flags **E-CIG retailers** and New York flags **VAPE** dealers explicitly, so you can pull vapor-only lists. Other states license tobacco and vapor together; those records carry their published license type. **Does it include phone numbers or e-mails?** NYC DCWP records carry a phone number; the other registries publish business name and address but not phone/e-mail. We never fabricate contact data — everything in the record is straight from the official source. **Why are some distributors or manufacturers located in another state?** Out-of-state distributors and manufacturers must hold a permit to ship into a state, so they appear in that state's registry. The record's `sourceState` is the licensing jurisdiction and `state` is the business's physical location. **Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive). **Is scraping this data legal?** This actor collects publicly available US government open data. You're responsible for using it in compliance with applicable laws and each agency's terms. ### Need help? Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained. # Actor input Schema ## `states` (type: `array`): License registries to scrape. Allowed values: TX (Texas), NY (New York State), NYC (New York City DCWP), PA (Pennsylvania), CO (Colorado), MO (Missouri). Leave empty to scrape all available jurisdictions. ## `businessRoles` (type: `array`): Keep only these supply-chain roles. Allowed values: retailer, distributor, wholesaler, manufacturer, importer, stamping\_agent, vending, itinerant, delivery. Leave empty for all. ## `productTypes` (type: `array`): Keep only businesses authorized for these products. Allowed values: cigarette, vape (e-cigarette / vapor), otp (other tobacco products — cigars, pipe, smokeless). Leave empty for all. ## `vapeOnly` (type: `boolean`): Keep only vape / e-cigarette retailers and vapor-product dealers (explicitly flagged in TX and NY). Ideal for vape distributors and disposable-vape brands. ## `retailersOnly` (type: `boolean`): Keep only retail storefronts (drops distributors, wholesalers and manufacturers). ## `distributorsOnly` (type: `boolean`): Keep only the supply chain — distributors, wholesalers, manufacturers and importers (drops retailers). Ideal for brands looking for placement partners. ## `cities` (type: `array`): Keep only businesses in these cities (case-insensitive exact match). Optional. ## `counties` (type: `array`): Keep only businesses in these counties (case-insensitive, e.g. "Harris", "Allegheny"). Applies to TX and PA, which publish a county. Optional. ## `zipCodes` (type: `array`): Keep only businesses whose ZIP starts with any of these values (full ZIP or prefix, e.g. "770" or "77002"). Optional. ## `nameQuery` (type: `string`): Keep only businesses whose name or DBA contains this text (case-insensitive), e.g. "smoke", "vape" or "7-eleven". Optional. ## `permittedAfter` (type: `string`): Keep only businesses whose permit/license was issued on or after this date — a fresh feed of newly-licensed tobacco & vape stores. Applies where an issue date is published (TX, NYC). ## `newlyPermittedOnly` (type: `boolean`): Keep only businesses permitted within the last 180 days (new-business GTM signal). ## `expiringBefore` (type: `string`): Keep only licenses that expire on or before this date — renewal-timing leads. Applies where an expiration date is published (PA, CO). ## `expiringWithinDays` (type: `integer`): Keep only licenses expiring within this many days from today (renewal-timing leads). Applies to PA and CO. Optional. ## `expiringSoonOnly` (type: `boolean`): Keep only licenses expiring within the next 120 days. ## `withPhoneOnly` (type: `boolean`): Keep only businesses that publish a phone number (NYC DCWP records carry a phone). ## `withGeoOnly` (type: `boolean`): Keep only businesses that have latitude/longitude coordinates (NY, NYC and PA publish geo). ## `minLeadScore` (type: `integer`): Keep only businesses with a lead score at or above this value (0-100). ## `sortBy` (type: `string`): Order of the output. ## `maxResults` (type: `integer`): Maximum number of business records to return across all selected jurisdictions. ## `maxResultsPerState` (type: `integer`): Optional cap on the number of records returned from each jurisdiction (useful for balanced multi-state pulls). Leave empty for no per-jurisdiction cap. ## `deduplicateResults` (type: `boolean`): Drop duplicate businesses that share the same license number / name / address within a jurisdiction. ## `includeRawFields` (type: `boolean`): Attach the raw source row under sourceFields on each record. ## `monitorMode` (type: `boolean`): Only return businesses that are new or whose name, address, license type, license number or dates changed since the last run with the same monitor key. Ideal on a Schedule to capture newly-licensed tobacco & vape stores as fresh leads. Works alongside Apify Schedules — the schedule triggers the run, this flag controls what is emitted. ## `monitorKey` (type: `string`): Namespace for monitoring mode so independent monitors don't collide. Use a distinct key per saved configuration. ## `socrataAppToken` (type: `string`): Optional Socrata App Token to raise open-data rate limits on very large scheduled pulls. Not required — leave blank for normal use. ## `proxyConfiguration` (type: `object`): Optional. These Socrata open-data APIs need no proxy, so leave this off for the fastest queries. ## Actor input object example ```json { "states": [ "CO" ], "vapeOnly": false, "retailersOnly": false, "distributorsOnly": false, "newlyPermittedOnly": false, "expiringSoonOnly": false, "withPhoneOnly": false, "withGeoOnly": false, "sortBy": "leadScore", "maxResults": 1000, "deduplicateResults": true, "includeRawFields": true, "monitorMode": false, "monitorKey": "default", "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): All scraped tobacco/vape business records in the default dataset, each with firmographics, product types, business role, license details and a lead score. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "states": [ "CO" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/us-tobacco-vape-retailer-leads").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "states": ["CO"] } # Run the Actor and wait for it to finish run = client.actor("scrapesage/us-tobacco-vape-retailer-leads").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "states": [ "CO" ] }' | apify call scrapesage/us-tobacco-vape-retailer-leads --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/us-tobacco-vape-retailer-leads", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "US Tobacco, Vape & Smoke Shop Retailer Leads Scraper", "description": "Scrape US tobacco, vape & smoke-shop leads from official state & city license registries (TX, NY, NYC, PA, CO, MO): name, DBA, address, product types, vape/e-cig flag, distributor & wholesaler roles, license type, new-permit & expiration signals + lead score. Filter & monitor new licenses.", "version": "0.1", "x-build-id": "cvHA6GX3TGIjpwHhj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~us-tobacco-vape-retailer-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-us-tobacco-vape-retailer-leads", "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/scrapesage~us-tobacco-vape-retailer-leads/runs": { "post": { "operationId": "runs-sync-scrapesage-us-tobacco-vape-retailer-leads", "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/scrapesage~us-tobacco-vape-retailer-leads/run-sync": { "post": { "operationId": "run-sync-scrapesage-us-tobacco-vape-retailer-leads", "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": "Jurisdictions", "uniqueItems": true, "type": "array", "description": "License registries to scrape. Allowed values: TX (Texas), NY (New York State), NYC (New York City DCWP), PA (Pennsylvania), CO (Colorado), MO (Missouri). Leave empty to scrape all available jurisdictions.", "items": { "type": "string" } }, "businessRoles": { "title": "Business roles", "uniqueItems": true, "type": "array", "description": "Keep only these supply-chain roles. Allowed values: retailer, distributor, wholesaler, manufacturer, importer, stamping_agent, vending, itinerant, delivery. Leave empty for all.", "items": { "type": "string" } }, "productTypes": { "title": "Product types", "uniqueItems": true, "type": "array", "description": "Keep only businesses authorized for these products. Allowed values: cigarette, vape (e-cigarette / vapor), otp (other tobacco products — cigars, pipe, smokeless). Leave empty for all.", "items": { "type": "string" } }, "vapeOnly": { "title": "Vape / e-cigarette only", "type": "boolean", "description": "Keep only vape / e-cigarette retailers and vapor-product dealers (explicitly flagged in TX and NY). Ideal for vape distributors and disposable-vape brands.", "default": false }, "retailersOnly": { "title": "Retailers only", "type": "boolean", "description": "Keep only retail storefronts (drops distributors, wholesalers and manufacturers).", "default": false }, "distributorsOnly": { "title": "Distributors / wholesalers only", "type": "boolean", "description": "Keep only the supply chain — distributors, wholesalers, manufacturers and importers (drops retailers). Ideal for brands looking for placement partners.", "default": false }, "cities": { "title": "Cities", "uniqueItems": true, "type": "array", "description": "Keep only businesses in these cities (case-insensitive exact match). Optional.", "items": { "type": "string" } }, "counties": { "title": "Counties", "uniqueItems": true, "type": "array", "description": "Keep only businesses in these counties (case-insensitive, e.g. \"Harris\", \"Allegheny\"). Applies to TX and PA, which publish a county. Optional.", "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes", "uniqueItems": true, "type": "array", "description": "Keep only businesses whose ZIP starts with any of these values (full ZIP or prefix, e.g. \"770\" or \"77002\"). Optional.", "items": { "type": "string" } }, "nameQuery": { "title": "Business name contains", "type": "string", "description": "Keep only businesses whose name or DBA contains this text (case-insensitive), e.g. \"smoke\", \"vape\" or \"7-eleven\". Optional." }, "permittedAfter": { "title": "Permitted after (YYYY-MM-DD)", "type": "string", "description": "Keep only businesses whose permit/license was issued on or after this date — a fresh feed of newly-licensed tobacco & vape stores. Applies where an issue date is published (TX, NYC)." }, "newlyPermittedOnly": { "title": "Newly permitted only", "type": "boolean", "description": "Keep only businesses permitted within the last 180 days (new-business GTM signal).", "default": false }, "expiringBefore": { "title": "License expiring before (YYYY-MM-DD)", "type": "string", "description": "Keep only licenses that expire on or before this date — renewal-timing leads. Applies where an expiration date is published (PA, CO)." }, "expiringWithinDays": { "title": "License expiring within N days", "minimum": 1, "type": "integer", "description": "Keep only licenses expiring within this many days from today (renewal-timing leads). Applies to PA and CO. Optional." }, "expiringSoonOnly": { "title": "Expiring soon only", "type": "boolean", "description": "Keep only licenses expiring within the next 120 days.", "default": false }, "withPhoneOnly": { "title": "With phone only", "type": "boolean", "description": "Keep only businesses that publish a phone number (NYC DCWP records carry a phone).", "default": false }, "withGeoOnly": { "title": "With coordinates only", "type": "boolean", "description": "Keep only businesses that have latitude/longitude coordinates (NY, NYC and PA publish geo).", "default": false }, "minLeadScore": { "title": "Minimum lead score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Keep only businesses with a lead score at or above this value (0-100)." }, "sortBy": { "title": "Sort by", "enum": [ "leadScore", "newest", "expiringSoon", "name", "state", "source" ], "type": "string", "description": "Order of the output.", "default": "leadScore" }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of business records to return across all selected jurisdictions.", "default": 1000 }, "maxResultsPerState": { "title": "Max results per jurisdiction", "minimum": 1, "type": "integer", "description": "Optional cap on the number of records returned from each jurisdiction (useful for balanced multi-state pulls). Leave empty for no per-jurisdiction cap." }, "deduplicateResults": { "title": "Deduplicate", "type": "boolean", "description": "Drop duplicate businesses that share the same license number / name / address within a jurisdiction.", "default": true }, "includeRawFields": { "title": "Include raw source fields", "type": "boolean", "description": "Attach the raw source row under sourceFields on each record.", "default": true }, "monitorMode": { "title": "Monitoring mode (only new / changed)", "type": "boolean", "description": "Only return businesses that are new or whose name, address, license type, license number or dates changed since the last run with the same monitor key. Ideal on a Schedule to capture newly-licensed tobacco & vape stores as fresh leads. Works alongside Apify Schedules — the schedule triggers the run, this flag controls what is emitted.", "default": false }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Namespace for monitoring mode so independent monitors don't collide. Use a distinct key per saved configuration.", "default": "default" }, "socrataAppToken": { "title": "Socrata app token (optional)", "type": "string", "description": "Optional Socrata App Token to raise open-data rate limits on very large scheduled pulls. Not required — leave blank for normal use." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. These Socrata open-data APIs need no proxy, so leave this off for the fastest queries.", "default": { "useApifyProxy": 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 } } } } } } } } } } ```