You can access the Socrata Catalog Snapshot 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 API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

1import { ApifyClient } from 'apify-client';
2
3// Initialize the ApifyClient with your Apify API token
4// Replace the '<YOUR_API_TOKEN>' with your token
5const client = new ApifyClient({
6    token: '<YOUR_API_TOKEN>',
7});
8
9// Prepare Actor input
10const input = {
11    "buyerQuery": "buyer-ready records with source evidence",
12    "taskIntent": "buyer-ready-product-run",
13    "sourceMode": "startUrls",
14    "outputMode": "buyer-ready-records",
15    "startUrls": [
16        {
17            "url": "https://api.us.socrata.com/api/catalog/v1?q=building%20permits"
18        }
19    ],
20    "maxItems": 1,
21    "perSourceLimit": 25,
22    "overallTimeoutSecs": 900,
23    "requestTimeoutSecs": 30,
24    "maxRequestRetries": 2,
25    "sinceLastRun": false,
26    "deltaMode": true
27};
28
29// Run the Actor and wait for it to finish
30const run = await client.actor("zentrafoundry/open-data-portal-signals").call(input);
31
32// Fetch and print Actor results from the run's dataset (if any)
33console.log('Results from dataset');
34console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
35const { items } = await client.dataset(run.defaultDatasetId).listItems();
36items.forEach((item) => {
37    console.dir(item);
38});
39
40// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

Socrata catalog permits — not issued permit rows API in JavaScript

The Apify API client for JavaScript is the official library that allows you to use Socrata Catalog Snapshot API in JavaScript or TypeScript, providing convenience functions and automatic retries on errors.

Install the apify-client

$npm install apify-client

Other API clients include:

Socrata Catalog Snapshot API in Python

Socrata Catalog Snapshot API through CLI

Socrata Catalog Snapshot OpenAPI definition

Socrata Catalog Snapshot API

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

Socrata Dataset Catalog Scraper - Open Data

benthepythondev/socrata-dataset-catalog-scraper

Search public Socrata datasets and export IDs, names, descriptions, domains, categories, tags, columns, views, license and links.

Ben

Building Permits Data — Any Socrata City/County, One Schema

engineertsaistudio/county-permit-contractor-normalizer

Free: pull building permits from any Socrata city or county open-data portal into one flat schema — permit ID, date, status, address, contractor name and phone, work description.

Studio EngineerTsai

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

bujhmml/building-permits-scraper

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.

Ihor Bielievskiy

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

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

Socrata Open Data Exporter: Permits, Licenses & Inspections

doggo/socrata-opendata-exporter

Download datasets from 200+ government Socrata open data portals: building permits, business licenses, inspections, 311 requests and more. Filter by column and export every row. No API key. Output to CSV, JSON or Excel.

Doggo

New Contractor Alerts from Building Permits (Socrata)

engineertsaistudio/contractor-activity-signals

Turn public building-permit data into contractor signals: first-seen contractors, new projects by known contractors, repeat activity and watchlist matches. Any Socrata city or county portal.

Studio EngineerTsai