Chicago Business Licenses Scraper

This Apify actor extracts business license data from Chicago's Open Data Portal, providing comprehensive information about business licenses, permits, and regulatory compliance.

Features

• Extracts data from Chicago's official Socrata API (data.cityofchicago.org)
• Supports flexible filtering by license type, business name, location, and status
• Includes detailed business information, licensing history, and geographic data
• Returns structured data with comprehensive business details
• Rate-limited to be respectful to the city's API

Data Extracted

Each business license record includes:

• Business Information: Legal name, DBA name, account/license numbers
• License Details: Type, description, code, status, start/expiration dates
• Location Data: Full address, ward, precinct, community area, neighborhood
• Geographic Data: Latitude/longitude coordinates
• Administrative Info: Application dates, payment info, approval status
• Metadata: Unique identifiers and scrape timestamp

Input Parameters

• License Type: Filter by license description (e.g., "Restaurant", "Retail Food")
• Business Name: Search for specific business names (partial matching)
• Ward: Filter by Chicago ward number (1-50)
• Community Area: Filter by community area name (e.g., "Loop", "Lincoln Park")
• Neighborhood: Filter by neighborhood name
• ZIP Code: Filter by ZIP code
• License Status: Filter by status (ISSUED, EXPIRED, CANCELLED, etc.)
• Active Only: Show only currently active licenses
• Max Items: Limit the number of records returned (default: 1000, max: 50000)

Use Cases

• Compliance Monitoring: Track licensing status for businesses
• Market Research: Analyze business density and types by location
• Competition Analysis: Identify competitors in specific areas
• Due Diligence: Verify business licensing before partnerships
• Regulatory Analysis: Study licensing patterns and compliance rates
• Economic Development: Understand business distribution across the city

Data Source

This actor uses Chicago's official Open Data API:

• Source: City of Chicago Data Portal
• Dataset: Business Licenses (ID: r5kz-chrr)
• Update Frequency: Daily
• API: Socrata SODA API

Geographic Filtering

The actor supports multiple geographic filters:

• Ward: Chicago's 50 political districts
• Community Area: 77 designated areas for planning and statistics
• Neighborhood: Local neighborhood names
• Police District: Law enforcement jurisdictions
• ZIP Code: Postal code areas

Rate Limits

The actor includes built-in rate limiting (100ms between requests) to ensure respectful API usage.

Output Format

Data is returned in JSON format with the following structure:

{
  "id": "12345",
  "licenseId": "67890",
  "accountNumber": "11111",
  "siteNumber": "1",
  "legalName": "EXAMPLE BUSINESS INC",
  "doingBusinessAsName": "Example Store",
  "address": "123 Main St",
  "city": "CHICAGO",
  "state": "IL",
  "zipCode": "60601",
  "ward": 42,
  "precinct": 1,
  "communityArea": 32,
  "communityAreaName": "LOOP",
  "neighborhood": "Loop",
  "licenseCode": 1234,
  "licenseDescription": "Retail Food Establishment",
  "businessActivity": "CONVENIENCE STORE",
  "licenseNumber": "1234567",
  "licenseStartDate": "2024-01-01T00:00:00.000",
  "licenseExpirationDate": "2024-12-31T00:00:00.000",
  "licenseStatus": "ISSUED",
  "latitude": 41.8781,
  "longitude": -87.6298,
  "scrapedAt": "2024-01-16T10:30:45.123Z"
}

Legal and Ethical Use

This data is publicly available through Chicago's Open Data Portal. Users should:

• Verify data accuracy before making business decisions
• Respect the original data licensing terms
• Use responsibly and ethically
• Not overload the city's servers

Support

For issues or questions about this actor, please contact the developer or check the Apify marketplace for updates.