NewLiquorLicenses API Documentation

US liquor-license data aggregated from state Alcohol Beverage Control boards into one normalized API. A directory of licensed businesses (not individuals): each record carries the business/establishment name, business address, city, county, state, license type, license number, status, and issue and…

Documentation menu

Getting started

Quickstart

Guides

Authentication Filtering & pagination Export to CSV Monitor new records Errors

Cookbook

Overview New license leads Active by city

Endpoints

GET/liquor_license GET/liquor_license/stats GET/liquor_license/coverage GET/liquor_license/{record_id}

Quickstart

Three steps to your first call:

Subscribe on RapidAPI and copy your key (there is a free tier).
Call the base URL https://newliquorlicenses-us-liquor-license-data.p.rapidapi.com with your key in the headers.
Parse the JSON response.

curl --request GET \
  --url 'https://newliquorlicenses-us-liquor-license-data.p.rapidapi.com/liquor_license' \
  --header 'x-rapidapi-host: newliquorlicenses-us-liquor-license-data.p.rapidapi.com' \
  --header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'

import requests

url = "https://newliquorlicenses-us-liquor-license-data.p.rapidapi.com/liquor_license"
headers = {"x-rapidapi-host": "newliquorlicenses-us-liquor-license-data.p.rapidapi.com", "x-rapidapi-key": "YOUR_RAPIDAPI_KEY"}
resp = requests.get(url, headers=headers)
print(resp.json())

const res = await fetch("https://newliquorlicenses-us-liquor-license-data.p.rapidapi.com/liquor_license", {
  headers: {
    "x-rapidapi-host": "newliquorlicenses-us-liquor-license-data.p.rapidapi.com",
    "x-rapidapi-key": "YOUR_RAPIDAPI_KEY",
  },
});
const data = await res.json();
console.log(data);

<?php
$ch = curl_init("https://newliquorlicenses-us-liquor-license-data.p.rapidapi.com/liquor_license");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-rapidapi-host: newliquorlicenses-us-liquor-license-data.p.rapidapi.com",
    "x-rapidapi-key: YOUR_RAPIDAPI_KEY",
]);
echo curl_exec($ch);

require "net/http"
require "uri"

uri = URI("https://newliquorlicenses-us-liquor-license-data.p.rapidapi.com/liquor_license")
req = Net::HTTP::Get.new(uri)
req["x-rapidapi-host"] = "newliquorlicenses-us-liquor-license-data.p.rapidapi.com"
req["x-rapidapi-key"] = "YOUR_RAPIDAPI_KEY"
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://newliquorlicenses-us-liquor-license-data.p.rapidapi.com/liquor_license", nil)
    req.Header.Add("x-rapidapi-host", "newliquorlicenses-us-liquor-license-data.p.rapidapi.com")
    req.Header.Add("x-rapidapi-key", "YOUR_RAPIDAPI_KEY")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)
    fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.*;

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://newliquorlicenses-us-liquor-license-data.p.rapidapi.com/liquor_license"))
    .header("x-rapidapi-host", "newliquorlicenses-us-liquor-license-data.p.rapidapi.com")
    .header("x-rapidapi-key", "YOUR_RAPIDAPI_KEY")
    .build();
HttpResponse<String> res = HttpClient.newHttpClient()
    .send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

Guides

Getting started and authenticationGet an API key and make your first authenticated call in under five minutes.Filtering, search and paginationNarrow results with filters and full-text search, and page through large result sets.Export results to CSV or a spreadsheetPull records across pages and write them to a CSV you can open in Excel or Sheets.Monitor new recordsPoll for records added since your last check and act on them automatically.Errors and troubleshootingWhat each status code means, and how to read the message the API sends back.

Cookbook

Copy-paste recipes for common NewLiquorLicenses tasks.

Get newly issued liquor licenses (fresh leads)A new liquor license is a new bar or restaurant opening, pull them by state for POS, payments and supplier prospecting.List active licenses in a cityEvery currently active license in a city, for market sizing or a territory plan.

Endpoint reference

Every NewLiquorLicenses route. Click through for parameters, examples and a sample response.

GET/liquor_licenseSearch liquor licenses GET/liquor_license/statsLiquor license statistics GET/liquor_license/coverageLiquor license count per state GET/liquor_license/{record_id}Get liquor license by ID

Ready to build?Subscribe on RapidAPI to get your key and start calling NewLiquorLicenses in minutes.

Get your API key →