# US Building Permits: New Construction Permits, NYC, Chicago, LA (`euroscrape/us-building-permits`) Actor

New construction permits in Austin, NYC, Chicago, LA, SF, Seattle: building permits USA, construction leads USA, residential permits, contractor leads, building permit alerts. Keyword (roof), cost, last N days. {"cities":\["austin"],"daysBack":30,"keywords":\["roof"]}. Pay per permit.

- **URL**: https://apify.com/euroscrape/us-building-permits.md
- **Developed by:** [EuroScrape](https://apify.com/euroscrape) (community)
- **Categories:** Real estate, Lead generation, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.40 / 1,000 building permits

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## US Building Permits: NYC, Chicago, LA, SF, Austin, Seattle

> **For AI agents:** use this Actor for new building permits in New York, Chicago, Los Angeles, San Francisco, Austin and Seattle, by category or keyword (roof, solar, pool…). Minimal input: `{"cities": ["austin"], "daysBack": 14, "maxPermitsPerCity": 50}`. Returns one row per permit with type, description, status, dates, address, estimated cost and contractor.

Get the **building permits issued in six of the largest US cities**, straight from each city's **official open-data portal**, in **one format**: permit number, category (new building, alteration, demolition, electrical, plumbing, mechanical, sign…), the city's own permit and work type, work description, address and ZIP, residential or commercial use, estimated cost, housing units, **contractor company**, owner company, issue and application dates, and the link to the record.

**Official open data, read from the cities' own APIs. No login, no API key, no proxy. Companies only: owners' and applicants' personal names are never returned. The first 20 permits of every run are free.**

#### 🤖 At a glance (for people and AI assistants)

- **Use it when** you want **building permits** (construction permits, permits issued, new construction, renovations, demolitions, contractor leads) in **New York City, Chicago, Los Angeles, San Francisco, Austin or Seattle**, by date, category, cost, ZIP code or keyword, or a **daily feed of new permits** for sales prospecting, construction market research or real-estate monitoring.
- **Minimal input**: `{ "cities": ["austin", "seattle"], "daysBack": 14, "categories": ["new_building"] }`
- **Output**: one row per permit: `city`, `permitNumber`, `category`, `permitType`, `workType`, `description`, `useClass`, `estimatedCost`, `housingUnits`, `address`, `zip`, `district`, `latitude`, `longitude`, `contractor`, `contractorTrade`, `ownerBusiness`, `issueDate`, `appliedDate`, `sourceUrl`; plus one free `summary` row per city (counts by category, use and day, median cost, top contractor companies).
- **Price**: $2 per 1,000 permits, plus $0.003 per run. **First 20 permits of every run free.**
- **Not for**: other cities (ask for yours in a review), permit applications not yet issued, inspections, violations, or the names of individual owners and applicants (never returned).
- **Look before you run**: the free [US building permits this week](https://euroscrape.com/tools/us-building-permits-this-week) viewer lists a city's latest permits in your browser and writes this Actor's input. Each city over 30 days, with its most active contractors: [building permits in six US cities](https://euroscrape.com/us/building-permits/).

### ✨ Why this Actor

| | |
|---|---|
| 🏗️ **Six cities, one format** | 6,102 permits issued in one week (31 Oct – 6 Nov 2026): New York 3,615 · Austin 1,277 · Chicago 715 · San Francisco 344 · Seattle 136 · Los Angeles 15 (LA publishes weekly, a week late). |
| 🧭 **Normalised categories** | Each city has its own permit types; the Actor maps them to `new_building`, `addition_alteration`, `demolition`, `electrical`, `plumbing`, `mechanical`, `sign`, `pool`, `grading`, `other`, and keeps the city's own type next to it. |
| 💵 **Cost and size** | Estimated cost or declared valuation (New York, Chicago, LA, SF, Austin, Seattle), housing units and stories when the city gives them. |
| 👷 **Contractor companies** | New York, Chicago and Austin publish the contractor on the permit: company name, trade and licence. Owner companies too. **Individuals are never returned.** |
| 🎯 **Filters for a lead list** | City, category, residential or commercial, minimum cost, ZIP codes, keywords in the description (roof, solar, kitchen, ADU…), permits naming a contractor, initial permits only. |
| 🔔 **Monitor + alerts** | Give the search a monitor name and schedule it: each run returns **only permits not delivered before**. New permits can go to **Telegram, Discord, Slack or a webhook**. |
| 🤝 **Respectful of the source** | Reads the cities' Socrata open-data APIs, identified, 4 requests per second; the data is published for re-use by each city. |

### 🎯 Use cases

- **Building-material suppliers, trades, equipment rental**: new buildings and large alterations issued this week in your city, with the general contractor's name.
- **Contractors and architects**: who is building what, where; your competitors' permits by ZIP code.
- **Real-estate investors and analysts**: new residential units permitted by neighbourhood, demolitions, declared costs.
- **Solar, HVAC, roofing, kitchen and bath companies**: permits whose description mentions your trade, every morning, in Slack.

### 🚀 Examples

New buildings permitted in Austin and Seattle in the last 14 days:

```json
{ "cities": ["austin", "seattle"], "daysBack": 14, "categories": ["new_building"], "maxPermitsPerCity": 100 }
```

Commercial permits of $100,000 or more in Los Angeles and San Francisco over 30 days:

```json
{ "cities": ["los-angeles", "san-francisco"], "daysBack": 30, "useClass": "commercial", "minEstimatedCost": 100000 }
```

New York: initial permits for general construction naming a contractor, Brooklyn ZIP codes:

```json
{ "cities": ["new-york"], "daysBack": 7, "keywords": ["General Construction"], "initialPermitsOnly": true, "withContractorOnly": true, "zipCodes": ["11201", "11211", "11215", "11217", "11222"] }
```

Solar and roofing permits in all six cities, every morning in Slack (see "Run it on a schedule" below):

```json
{ "daysBack": 3, "keywords": ["solar", "roof"], "monitorName": "solar-roof-permits", "slackWebhookUrl": "https://hooks.slack.com/services/…" }
```

### 📊 Data Report · week of 31 October – 6 November 2026: 6,102 permits in six cities

One run (`dateFrom: "2026-10-31"`, `dateTo: "2026-11-06"`, all cities, no filter), read on 8 November 2026: **6,102 permits in 70 seconds, 0 read errors**.

| City | Permits | Median estimated cost | Permits of $1M+ | Contractor named | Notes |
|---|---:|---:|---:|---:|---|
| New York City | 3,615 | $35,040 (3,006 with a cost) | 261 | 3,615 | 2,121 initial permits, 1,455 renewals; Manhattan 1,291 · Brooklyn 927 · Queens 771 |
| Austin | 1,277 | n/a (valuation rarely declared) | 5 | 1,132 | electrical 463 · plumbing 345 · mechanical 221 · new buildings 65 |
| Chicago | 715 | $18,950 (589) | 20 | 588 | alterations 450 · electrical 112 · signs 66 · new buildings 20 |
| San Francisco | 344 | $21,733 (344) | 11 | 0 | 341 over-the-counter alterations |
| Seattle | 136 | $120,438 (135) | 8 | 0 | new buildings 33 · demolitions 7 |
| Los Angeles | 15 | $5,600 | 0 | 0 | dataset refreshed weekly, last issue date 31 Oct |

Across the six cities: additions and alterations 2,581 · site protection and other 1,310 (New York's sidewalk sheds, scaffolds and fences alone: 825) · plumbing 782 · electrical 575 · mechanical 555 · **new buildings 121** · signs 103 · demolitions 75. Largest permits of the week: an 11-storey building in Chicago ($52.2M), a 9-storey, 168-unit residential building in San Francisco ($48M), an 8-storey affordable-housing building in New York ($43.4M).

Most frequent contractor companies on the week's permits: New York, a scaffolding and a consulting firm with 60 and 46 permits; Austin, a battery installer with 105 permits (the "auxiliary power" wave) and an electrical contractor with 52; Chicago, a solar installer with 17.

Fields filled on these 6,102 permits: permit number, city, category, issue date and address 100 %; description 100 %; estimated cost 68 % (New York 83 %, Chicago 82 %, SF, Seattle and LA 100 %, Austin 7 %); contractor company 87 % (New York 100 %, Austin 89 %, Chicago 82 %; not published by SF, Seattle and LA); coordinates 97 %.

### 📦 Output (a real permit, Seattle, 6 November 2026)

```json
{
  "type": "permit",
  "city": "seattle",
  "cityLabel": "Seattle",
  "state": "WA",
  "permitNumber": "7136280-CN",
  "category": "new_building",
  "permitType": "Building / New",
  "workType": "Single Family/Duplex",
  "description": "Construct new southeast one-family dwelling (Bldg 1) per plan. (Establish use as housing for six detached dwelling units per land use code. Construct 6 new one-family dwellings per plan. Review and processing for 6 records under 7136280-CN)",
  "useClass": "residential",
  "status": "Issued",
  "issueDate": "2026-11-06",
  "appliedDate": "2026-06-12",
  "expirationDate": "2028-05-06",
  "address": "2535 31st Ave W",
  "zip": "98199",
  "latitude": 47.64231445,
  "longitude": -122.39724458,
  "estimatedCost": 352518,
  "housingUnits": 1,
  "contractor": null,
  "ownerBusiness": null,
  "sourceUrl": "https://services.seattle.gov/portal/customize/LinkToRecord.aspx?altId=7136280-CN",
  "datasetUrl": "https://data.seattle.gov/d/76t5-zqzr",
  "source": "Seattle Department of Construction and Inspections, Building Permits (Seattle Open Data)",
  "scrapedAt": "2026-11-08T02:10:31.000Z"
}
```

The free `summary` row of a city:

```json
{ "type": "summary", "city": "seattle", "period": { "from": "2026-10-31", "to": "2026-11-06" }, "permits": 136, "permitsInPeriod": 136, "byCategory": { "addition_alteration": 86, "new_building": 33, "other": 10, "demolition": 7 }, "byUseClass": { "residential": 101, "commercial": 35 }, "byIssueDate": { "2026-11-02": 31, "2026-11-03": 24, "2026-11-04": 29, "2026-11-05": 27, "2026-11-06": 25 }, "withEstimatedCost": 135, "medianEstimatedCost": 120438, "totalEstimatedCost": 55051901, "housingUnits": 32, "topContractors": [] }
```

### 💰 Pricing

| Event | Price |
|---|---|
| Permit (one row) | **$2 / 1,000 permits** — the **first 20 of every run are free** |
| Summary rows | free |
| Run start | $0.003 |

The 6,102 permits of the week above cost $12.16; a daily monitor on one city's new buildings and demolitions costs a few cents a day. Set a maximum charge per run in the run options: the Actor stops cleanly when it is reached.

### ❓ FAQ

- **Where does the data come from?** From each city's official open-data portal: NYC Open Data (DOB NOW: Build, approved permits), Chicago Data Portal (building permits), LA Open Data (LADBS permits), DataSF (DBI permits), Austin Open Data (issued construction permits), Seattle Open Data (SDCI permits). Published by the cities for re-use.
- **How fresh is it?** New York, Chicago, San Francisco, Austin and Seattle were up to date to the previous working day on 8 November 2026. Los Angeles refreshes weekly, about a week late. A monitor with `daysBack: 7` or more run daily catches late rows.
- **Why is New York's `new_building` count zero?** DOB NOW labels new buildings and alterations alike as "General Construction"; the Actor files them under `addition_alteration` and keeps the city's `workType`. Use `keywords: ["new building"]` on the description to find new buildings in New York.
- **What are New York's "renewals"?** DOB NOW publishes a row each time a permit is renewed. Set `initialPermitsOnly: true` to keep first-time permits.
- **Why so few costs in Austin?** The city publishes a valuation on building permits only, and most Austin rows are trade permits (electrical, plumbing, mechanical).
- **Names of owners or applicants?** Never returned. Company names are kept (contractor, architect, owner company); individuals are dropped even when the city publishes them.
- **Can you add my city?** The Actor reads Socrata portals; most large US cities have one. Ask in a review with the dataset link.

*Data source: open-data portals of the cities of New York, Chicago, Los Angeles, San Francisco, Austin and Seattle. Not affiliated with any of them.*

### 🔌 API, AI agents and integrations

- **API**: one call runs the Actor and returns the results, `POST https://api.apify.com/v2/acts/euroscrape~us-building-permits/run-sync-get-dataset-items` (see the API tab for Python, JavaScript and cURL).
- **AI agents (MCP)**: add `https://mcp.apify.com?tools=euroscrape/us-building-permits` to Claude, Cursor, VS Code or any MCP client, and the Actor becomes a tool your agent can call.
- **No-code automation**: start runs and pass the results on with Apify's integrations for n8n, Make and Zapier, or with a webhook when a run ends.
- **Exports**: every result set downloads as JSON, CSV, Excel or XML, and can be sent to Google Sheets.
- **Data Reports**: twice a week, EuroScrape turns a run of one of its Actors into a 30-second data report on [LinkedIn](https://www.linkedin.com/company/euroscrape). Follow the page to see what the data looks like.

### 🗓️ Run it on a schedule: only new permits

1. Set your cities and filters and give the search a **monitor name**:

```json
{
  "cities": ["chicago"],
  "daysBack": 7,
  "categories": ["new_building", "demolition"],
  "monitorName": "chicago-new-and-demo",
  "webhookUrl": "https://hook.eu1.make.com/your-webhook-id"
}
```

2. In Apify Console, **save it as a task** and add a **schedule** to it (for example every morning at 13:00 UTC).
3. The first run is the baseline: it returns the matching permits and remembers all of them. Every run after that returns **only the permits not delivered before** (`changeType: "new"`), and you pay only for what is new (the first 20 of each run free).

**Straight into Google Sheets or your CRM:** put your Make, Zapier or n8n webhook address in `webhookUrl`. Each run sends one POST `{"count": N, "items": [...]}` with the new permits only (the baseline run sends nothing).

**Instant alerts:** add `telegramBotToken` + `telegramChatId`, `slackWebhookUrl` or `discordWebhookUrl` to get one message per new permit (up to `maxNotifications` per run, 30 by default).

### ⭐ Your feedback

If this Actor saves you time, a short review on Apify Store helps other users find it. Missing a city or a field (Houston, Phoenix, Philadelphia, Denver; inspections; electrical permits in New York)? Say it in your review: the most requested features are added first.

### 🔗 More from EuroScrape

- 🇫🇷 [France Building Permits](https://apify.com/euroscrape/france-building-permits): the French equivalent, from the national Sitadel register, with the developers' company data.
- 🇺🇸 [US New Business Leads](https://apify.com/euroscrape/us-new-companies) · 🇺🇸 [US Federal Contracts](https://apify.com/euroscrape/us-federal-contracts) · 🇺🇸 [US Startup Funding (SEC Form D)](https://apify.com/euroscrape/us-startup-funding).
- 📰 Data articles, daily data pages and real input/output examples for every Actor: [euroscrape.com](https://euroscrape.com).

# Actor input Schema

## `cities` (type: `array`):

Each city publishes its own permits on its open-data portal. Pick one or several.

## `daysBack` (type: `integer`):

Permits issued in the last N days. City datasets are updated daily to weekly and lag a few days. Ignored if 'From date' is set.

## `dateFrom` (type: `string`):

First issue date (YYYY-MM-DD).

## `dateTo` (type: `string`):

Last issue date (YYYY-MM-DD). Default: today.

## `categories` (type: `array`):

Normalised across cities from each city's permit and work types. Empty = all.

## `useClass` (type: `string`):

As declared by the city when it says so (unknown otherwise).

## `minEstimatedCost` (type: `integer`):

Keep permits whose declared valuation or estimated cost is at least this. New York and Chicago rarely publish a cost: they are excluded when this filter is set.

## `zipCodes` (type: `array`):

Keep permits in these 5-digit ZIP codes (Chicago has no ZIP: excluded when set).

## `keywords` (type: `array`):

Keep permits whose description, work or permit type, use, address or contractor contains one of these words (case and accents ignored). Example: roof, solar, kitchen, ADU.

## `excludeKeywords` (type: `array`):

Drop permits whose description, work type, address or contractor contains one of these words.

## `withContractorOnly` (type: `boolean`):

New York, Chicago and Austin publish the contractor; keep only those rows.

## `initialPermitsOnly` (type: `boolean`):

New York publishes permit renewals as new rows; keep only initial permits.

## `maxPermitsPerCity` (type: `integer`):

Stop after this many permits per city (newest first). The first 20 permits of every run are free. The form starts at 30 per city for a cheap first look; raise it (default 500) for full lists.

## `maxItems` (type: `integer`):

The first 20 of every run are free.

## `includeSummary` (type: `boolean`):

Counts by category, use and day, median estimated cost, top contractor companies.

## `socrataAppToken` (type: `string`):

Free token from any Socrata portal; raises the rate limit for very large runs. Not needed for normal use.

## `monitorName` (type: `string`):

Give the search a name and schedule it: each run returns only permits not delivered before, and can alert you. Leave empty for a one-off run.

## `telegramBotToken` (type: `string`):

Get a message for each new permit. Create a bot with @BotFather and paste its token.

## `telegramChatId` (type: `string`):

Your chat or group ID (send /start to the bot first).

## `discordWebhookUrl` (type: `string`):

Channel settings → Integrations → Webhooks.

## `slackWebhookUrl` (type: `string`):

Slack app → Incoming Webhooks.

## `webhookUrl` (type: `string`):

Receives one POST per run with the new permits: {"count": N, "items": \[...]}.

## `maxNotifications` (type: `integer`):

Telegram, Discord and Slack messages per run (the webhook always receives everything).

## Actor input object example

```json
{
  "cities": [
    "new-york",
    "chicago",
    "los-angeles",
    "san-francisco",
    "austin",
    "seattle"
  ],
  "daysBack": 14,
  "categories": [],
  "useClass": "any",
  "zipCodes": [],
  "keywords": [],
  "excludeKeywords": [],
  "withContractorOnly": false,
  "initialPermitsOnly": false,
  "maxPermitsPerCity": 30,
  "maxItems": 3000,
  "includeSummary": true,
  "maxNotifications": 30
}
```

# Actor output Schema

## `overview` (type: `string`):

One row per permit, plus a free summary row per city.

## `runSummary` (type: `string`):

Counters for this run (cities, rows read, permits by category, median cost, free rows, alerts).

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "cities": [
        "new-york",
        "chicago",
        "los-angeles",
        "san-francisco",
        "austin",
        "seattle"
    ],
    "daysBack": 14,
    "categories": [],
    "zipCodes": [],
    "keywords": [],
    "excludeKeywords": [],
    "maxPermitsPerCity": 30,
    "maxItems": 3000
};

// Run the Actor and wait for it to finish
const run = await client.actor("euroscrape/us-building-permits").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "cities": [
        "new-york",
        "chicago",
        "los-angeles",
        "san-francisco",
        "austin",
        "seattle",
    ],
    "daysBack": 14,
    "categories": [],
    "zipCodes": [],
    "keywords": [],
    "excludeKeywords": [],
    "maxPermitsPerCity": 30,
    "maxItems": 3000,
}

# Run the Actor and wait for it to finish
run = client.actor("euroscrape/us-building-permits").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "cities": [
    "new-york",
    "chicago",
    "los-angeles",
    "san-francisco",
    "austin",
    "seattle"
  ],
  "daysBack": 14,
  "categories": [],
  "zipCodes": [],
  "keywords": [],
  "excludeKeywords": [],
  "maxPermitsPerCity": 30,
  "maxItems": 3000
}' |
apify call euroscrape/us-building-permits --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,euroscrape/us-building-permits"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/yQuLPE3DbkFY4lMiV/builds/pFB5ToAzDVrorA1df/openapi.json
