Pricing

from $0.40 / 1,000 permits

Building Permits Scraper - Socrata Open Data (Multi-City)

Scrape building and construction permits from any Socrata open-data portal (NYC, SF, Chicago, LA, and hundreds more). Pull issue date, permit and work type, status, address, contractor, owner, coordinates and every column the dataset exposes. HTTP-first, multi-city in one run.

Pricing

from $0.40 / 1,000 permits

Rating

0.0

(0)

Developer

Ihor Bielievskiy

Actor stats

Bookmarked

Total users

Monthly active users

3 days ago

Last modified

Categories

Real estate

Lead generation

You can access the Building Permits Scraper - Socrata Open Data (Multi-City) 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": "1.2",
    "x-build-id": "snWgWTnXCW0zEml69"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/bujhmml~building-permits-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-bujhmml-building-permits-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/bujhmml~building-permits-scraper/runs": {
      "post": {
        "operationId": "runs-sync-bujhmml-building-permits-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/bujhmml~building-permits-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-bujhmml-building-permits-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": {
          "domain": {
            "title": "Socrata domain",
            "type": "string",
            "description": "Open-data host, e.g. data.cityofnewyork.us, data.sfgov.org, data.cityofchicago.org. Leave empty if you use the Datasets list below."
          },
          "datasetId": {
            "title": "Dataset id (4x4)",
            "pattern": "^[a-z0-9]{4}-[a-z0-9]{4}$",
            "type": "string",
            "description": "Socrata dataset identifier, the 4x4 code from the dataset URL (e.g. ipu4-2q9a for NYC DOB Permit Issuance)."
          },
          "searchQuery": {
            "title": "Keyword search",
            "maxLength": 2000,
            "type": "string",
            "description": "Full-text search across all text columns, e.g. solar, roofing, HVAC, demolition. Matches any permit whose text mentions the keyword. Applied to every dataset in the run."
          },
          "dateField": {
            "title": "Date column",
            "type": "string",
            "description": "Column to filter by date, e.g. issuance_date, issued_date, status_date. Required if you set Date from / Date to. Column names differ per dataset — check the dataset's columns."
          },
          "dateFrom": {
            "title": "Date from",
            "type": "string",
            "description": "Keep permits with Date column on or after this date. Format YYYY-MM-DD (e.g. 2024-01-01). Needs Date column set."
          },
          "dateTo": {
            "title": "Date to",
            "type": "string",
            "description": "Keep permits with Date column on or before this date. Format YYYY-MM-DD (e.g. 2024-12-31). Needs Date column set."
          },
          "whereClause": {
            "title": "Filter (SoQL $where)",
            "maxLength": 2000,
            "type": "string",
            "description": "Optional raw SoQL filter, e.g. borough='MANHATTAN' or estimated_cost > 50000. AND-merged with the date filter above. Leave empty for everything."
          },
          "select": {
            "title": "Columns to keep (SoQL $select)",
            "maxLength": 2000,
            "type": "string",
            "description": "Comma-separated columns to return, e.g. issuance_date, permit_type, address. Slims output and lowers cost. Leave empty for all columns. :id is added automatically for deduplication on column projections. Raw SoQL scoped to this single public dataset; aggregates like count(*) or borough, count(*) as n with a GROUP BY are passed through as-is (no :id injection, no dedup)."
          },
          "datasets": {
            "title": "Datasets (multi-city)",
            "type": "array",
            "description": "Scrape several cities/datasets in one run. Each item: { \"domain\": \"data.sfgov.org\", \"datasetId\": \"i98e-djp9\", \"whereClause\": \"...\", \"dateField\": \"...\", \"dateFrom\": \"...\", \"dateTo\": \"...\" }. Per-item filters override the global ones; if omitted, the global values apply. Runs in addition to the single domain/datasetId above."
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 0,
            "maximum": 10000000,
            "type": "integer",
            "description": "Stop after this many permit records across all datasets. 0 = no limit.",
            "default": 100
          },
          "order": {
            "title": "Sort order (SoQL $order)",
            "maxLength": 2000,
            "type": "string",
            "description": "Column(s) to sort by, e.g. issuance_date DESC for newest first. :id is always appended to keep pagination stable. Defaults to :id."
          },
          "appToken": {
            "title": "Socrata app token",
            "type": "string",
            "description": "Optional X-App-Token. Not required for moderate volume; raises Socrata's per-IP rate limits if you have one. A wrong token makes every request fail with 403."
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify Proxy. The Socrata API has no anti-bot, so proxies are optional; datacenter is plenty if you want one.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Building Permits Scraper - Socrata Open Data (Multi-City) 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 Building Permits Scraper - Socrata Open Data (Multi-City) 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:

Building Permits Scraper - Socrata Open Data (Multi-City) API in Python

Building Permits Scraper - Socrata Open Data (Multi-City) API in JavaScript

Building Permits Scraper - Socrata Open Data (Multi-City) API through CLI

Building Permits Scraper - Socrata Open Data (Multi-City) API

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

Socrata / Chicago Building Permits

moving_beacon-owner1/socrata-chicago-building-permits

Scrape data from any Socrata (SODA) open data portal, including Chicago Building Permits. Supports custom datasets, SoQL filters, pagination, sorting, and column selection. Export raw records to the Apify dataset, making it ideal for building permits, inspections, and 311 requests.

Jamshaid Arif

US Building-Permits Bulk Extractor (Socrata)

xtracto/building-permits

Extract millions of US building-permit records from city open-data portals (Socrata) — construction-activity intelligence. One permit per row. Public data, no login.

Farhan Febrian Nauval

Building Permits Search

hanamira/building-permits-search

Search building permits in Chicago, NYC, San Francisco, Seattle, Boston, Austin + any Socrata city. Filter by contractor, cost range, date. Find construction projects, renovations, permits. Official government open data for lead generation and market research.

hannah mira

US Building Permits Scraper — Multi-City Construction Leads

vivar_bolivar/us-building-permits-aggregator

Fresh building permits from official open-data APIs of NYC, Chicago, LA, SF, Seattle & Austin, normalized into one analysis-ready schema. Built for construction lead gen: contractors, valuations, addresses, geocodes.

Vivar Bolivar

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

US Building Permit Leads Scraper (Socrata)

devilscrapes/us-building-permit-leads-scraper

Pull fresh building and construction permit records from any US city or county Socrata open-data portal. We normalize permit ID, type, status, address, valuation, and contact info into one typed row per permit — ready to feed your contractor CRM or lead pipeline.

DevilScrapes

Seattle Building Permits Scraper

parseforge/seattle-permits-scraper

Scrape building permits from Seattle Open Data (Socrata). Filter by date, type, address, applicant, contractor. Get permit number, status, costs, units, descriptions. No API key required.

ParseForge

Building Permits Scraper

fortuitous_pirate/building-permits-scraper

Multi-City Building Permits Scraper. Structured data export for lead generation, enrichment, and competitive research.

Fortuitous Pirate

US Building & Construction Permit Leads

filingradar/us-building-permits

New building & construction permits from public city open-data (NYC + Chicago), normalized to one schema with project cost, contractor, geocode, and recency-based NEW flags. Public data only.

Filing Radar