Pricing

from $1.50 / 1,000 results

TTB Alcohol Permittee Scraper

Scrape federal alcohol permit records from TTB (Alcohol and Tobacco Tax and Trade Bureau). Download winery, distillery, importer and wholesaler permit lists with owner names, operating names, locations and new permit flags. No browser needed, direct CSV download.

Pricing

from $1.50 / 1,000 results

Rating

0.0

(0)

Developer

Haketa

Actor stats

Bookmarked

Total users

Monthly active users

20 hours ago

Last modified

Categories

Automation

Developer tools

Other

You can access the TTB Alcohol Permittee Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "jPyG3zAnBxtgMpe8v"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/haketa~ttb-alcohol-permittee-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-haketa-ttb-alcohol-permittee-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/haketa~ttb-alcohol-permittee-scraper/runs": {
      "post": {
        "operationId": "runs-sync-haketa-ttb-alcohol-permittee-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/haketa~ttb-alcohol-permittee-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-haketa-ttb-alcohol-permittee-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": {
          "permitCategories": {
            "title": "Permit Categories",
            "type": "array",
            "description": "TTB permit categories to scrape. Each category downloads a separate CSV file. Available: 'spirits' (Distilled Spirits Producers & Bottlers), 'wine' (Wine Producers & Blenders), 'wholesalers' (Basic Permit Wholesalers), 'importers' (Basic Permit Importers). Leave empty to scrape all categories. Note: brewery data is not publicly available.",
            "items": {
              "type": "string"
            }
          },
          "newPermitsOnly": {
            "title": "New Permits Only",
            "type": "boolean",
            "description": "Only return permits flagged as new this week (New_Permit_Flag = 1). Great for tracking newly opened wineries and distilleries.",
            "default": false
          },
          "stateFilter": {
            "title": "State Filter",
            "type": "array",
            "description": "Filter by US state codes. Examples: 'CA', 'NY', 'OR', 'TX'. Leave empty for all states.",
            "items": {
              "type": "string"
            }
          },
          "maxRecords": {
            "title": "Max Records",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum total records to save across all categories. Set 0 for unlimited.",
            "default": 100
          },
          "requestDelay": {
            "title": "Request Delay (ms)",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Delay between file downloads in milliseconds.",
            "default": 300
          },
          "proxyConfiguration": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Optional proxy settings. Usually not needed — TTB serves public files without restrictions."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

TTB Alcohol Permit Scraper — Wine & Spirits OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for TTB Alcohol Permittee Scraper from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

TTB Alcohol Permittee Scraper API in Python

TTB Alcohol Permittee Scraper API in JavaScript

TTB Alcohol Permittee Scraper API through CLI

TTB Alcohol Permittee Scraper API

TTB Alcohol Permittee Directory Scraper

jungle_synthesizer/ttb-alcohol-permittee-directory-scraper

Download 83,000+ federal alcohol permit records from the TTB FOIA public directory. Covers distilleries (DSP), wineries, alcohol importers, and wholesalers. Filter by permit type and state. Data includes permit number, business name, DBA, address, county, and industry type.

BowTiedRaccoon

Building Permit Scraper

lanky_quantifier/building-permit-tracker

Scrape building permit records from public databases. Extract permit number, address, owner, contractor, project type, and status. Monitor new construction and renovation activity. Export to JSON/CSV, run via API, schedule and monitor runs.

Vhub Systems

Building Permit & Project Intelligence Tracker

ramsford/building-permit-tracker

Monitors building permit applications and approvals across major US city open-data portals. Returns structured permit records with contractor, owner, address, type, valuation, and status — ideal for B2B lead generation in construction, real estate, and related verticals.

Don Johnson

Building Permit Scraper - 1000+ US Cities (Auto-Discovery)

intelscrape/building-permit-scraper

Get building permit data from 1000+ US cities in one click. Auto-discovers every Socrata open data portal. Returns permit type value contractor address and gentrification score.

IntelScrape

Multi City Building Permit Aggregator

george.the.developer/multi-city-building-permit-aggregator

Normalize public building permit data from NYC Open Data and the Chicago Data Portal into one JSON schema.

George Kioko

Building Permit Search - Multi-City

lulzasaur/building-permit-scraper

Search building permits across NYC, Chicago, LA, SF, and Austin via open data APIs. Get permit type, status, address, dates, and more.

lulz bot

Scrape Local Government Permits

spec-lab/scrape-local-government-permits

Scrapes local government permit and license application pages. Extracts structured data including permit types, requirements, fees, and application procedures from municipal websites. Outputs clean JSON format ready for analysis.

HAYATO YOKOSHIMA

Building Permit Lead Scraper — Contractor Lead Generation

samstorm/building-permit-lead-scraper

Scrape building permit data from city open-data portals for contractor lead generation. Find properties with active renovation, roofing, HVAC, and construction permits.

Sam Kleespies

Canada Building Permits Data API

lentic_clockss/canada-building-permits-search

Search Canadian building permits across 4 major cities (Calgary, Edmonton, Toronto, Vancouver) via SIP API. Access 280K+ permit records including contractor names, project costs, and permit details.

kane liu

US Building Permit Scraper — 248 Cities, Keyword Search

paxiq/us-building-permit-scraper

Keyword search across 248 US cities — find every solar, HVAC, roofing, or demolition permit in NYC, Chicago, LA, SF, Dallas, Seattle + 243 more. The only nationwide permit actor with keyword search. 63% US coverage. $0.002/result.