Chicago Business Licenses Scraper

Chicago Business Licenses Scraper

Scrape Chicago business licenses from the city's open data portal, up to a million per run. Each license comes with its status, legal name, address, and license code. No login or API key. Export to CSV, JSON, Excel, or XML.

Chicago's open data portal holds every business license issued by the city, but downloading it means manual CSV exports or fighting the Socrata API. This Actor reads the public dataset directly, filters by license status, and returns each match in one fixed schema.

Who uses it	What they scrape Chicago Business Licenses for
Market researchers	Which industries are growing in a given Chicago neighborhood
Lead generation teams	Build a list of active businesses with their legal names and addresses
Compliance officers	Monitor license status changes for risk assessment
Real estate analysts	Map commercial activity by license type and location

What it does

This Actor collects Chicago business licenses from the city's open data portal and returns each one as a flat row.

• 📊 Status filter: narrow to active, cancelled, revoked, reactivated, or inquiry licenses.
• 📦 Bulk export: pull up to 1,000,000 licenses per run, no pagination code.
• 🗂️ Flat schema: every license is one row, ready for CSV, JSON, Excel, or XML.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with Chicago Business Licenses data

📈 Track business formation trends.

A market researcher runs the Actor weekly with status=AAI to see which license types are growing in each Chicago ward.

🎯 Build a lead list of active businesses.

A sales team pulls all active licenses and filters by legal name and address to create a prospect list for B2B outreach.

🛡️ Monitor license revocations.

A compliance officer runs the Actor daily with status=REV to flag businesses that lost their license and update internal risk scores.

🏙️ Map commercial density.

A real estate analyst exports all licenses in a ZIP code and joins them with property data to identify retail corridors.

Why choose this scraper

	What you get
No API key	Reads the public Socrata dataset directly, no registration or token
Status filter	Get only active, cancelled, revoked, reactivated, or inquiry licenses
Bulk limit	Set maxItems from 1 to 1,000,000 to control run size
Fixed schema	Every record has the same fields, so downstream processing is predictable

How it compares

No other Store actor targets Chicago Business Licenses the same way, so the honest comparison is with the alternatives teams actually weigh.

	Chicago Business Licenses Scraper	Build it in-house	By hand
Setup	Run it now, zero config	Days of engineering	None, but hours per pull
When Chicago Business Licenses changes	Maintained for you	You fix it	You re-learn the page
Proxies, retries, anti-bot	Built in	Your problem	Browser only
Output	Fixed JSON schema, CSV/Excel export	Whatever you build	Copy-paste
Cost	Pay per result	Engineering time	Analyst hours

Configure the run

Drive the Actor with a maximum item count and an optional license status filter, and only matching licenses reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
  "maxItems": 10
}

A larger pull:

{
  "maxItems": 200
}

Pricing

Pay-per-result: $0.021 per result collected. You pay only for the results written to your dataset.

Results collected	Approximate cost
100 results	$2.10
1,000 results	$21.00
10,000 results	$210.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

1. Create a free Apify account with $5 in credit.
2. Open the Chicago Business Licenses Scraper.
3. Set your inputs and any filters, then click Start.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to Chicago Business Licenses through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

$claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/chicago-business-licenses-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check your licenseStatus filter. If you set it to a status that has no records in the current dataset, the run will return zero items. Try setting it to an empty string for any status.

The run takes too long or times out.

Reduce maxItems to a smaller number, or run without a status filter to avoid server-side filtering delays. The dataset is large, so fetching all records may take several minutes.

I see duplicate licenses in the output.

The city's dataset may contain multiple rows for the same business if it holds multiple licenses. Use the license number or account number field to deduplicate in your pipeline.

The output is missing some fields I expected.

The Actor returns all fields provided by the Socrata API for each record. If a field is empty for a particular license, it will be null or absent. Check the dataset preview to see the full schema.

FAQ

Question	Answer
What is the source of this data?	The Actor reads the City of Chicago's official open data portal, specifically the Business Licenses dataset published by the Department of Business Affairs and Consumer Protection.
How often is the dataset updated?	The city updates the dataset daily, and each run of this Actor fetches the latest snapshot available at that moment.
Can I filter by license type or location?	The input schema currently supports filtering by license status only. To filter by other fields, export the full dataset and filter locally, or contact support to request additional filters.
What does the license status code mean?	AAI means active, AAC means cancelled, REV means revoked, REA means reactivated, and INQ means inquiry. The Actor returns the raw code and you can map it to a label in your pipeline.
Is there a limit on how many licenses I can get?	You can set maxItems up to 1,000,000 per run. The dataset contains roughly 200,000 current licenses, so one run can capture the entire city.
Do I need an API key or login?	No. The Actor accesses the public Socrata endpoint without authentication, so you only need an Apify account to run it.
What format is the output?	Each license is returned as a flat JSON object. You can export the dataset to CSV, JSON, Excel, or XML from the Apify platform.
Can I schedule this Actor to run automatically?	Yes, you can set up a schedule in Apify to run the Actor daily, weekly, or at any interval, and receive the latest licenses in your storage.
Does this Actor scrape the city's website?	No, it reads the official Socrata API that powers the open data portal, which is the same data the city provides for public download.
What if I need historical license data?	The dataset includes current and past licenses with their status history. You can filter by status to get revoked or cancelled licenses, but the Actor does not provide point-in-time snapshots.

Related actors

Browse the full ParseForge collection for more scrapers.

🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by City of Chicago. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.