{
  "openapi": "3.0.1",
  "info": {
    "title": "Illinois License Scraper | IDFPR 1.2M+ Records",
    "description": "Illinois IDFPR license scraper & API: search Department of Financial and Professional Regulation licenses and export license number, profession, status, name, address and expiry. License verification, compliance and B2B lead generation — fast, no login.",
    "version": "1.0",
    "x-build-id": "xMjs4bBSknhQeB5c8"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/haketa~illinois-idfpr-license-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-haketa-illinois-idfpr-license-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/haketa~illinois-idfpr-license-scraper/runs": {
      "post": {
        "operationId": "runs-sync-haketa-illinois-idfpr-license-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/haketa~illinois-idfpr-license-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-haketa-illinois-idfpr-license-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": {
          "licenseTypes": {
            "title": "Profession / License Type",
            "type": "array",
            "description": "Choose one or more professions to pull. Leave empty to include every profession. This is the main filter most people use.",
            "items": {
              "type": "string",
              "enum": [
                "PHARMACY",
                "NURSING BOARD",
                "ADV PRACTICE NURSE",
                "MEDICAL BOARD",
                "PHYSICIAN ASSISTANT",
                "DENTAL",
                "REAL ESTATE",
                "APPRAISAL",
                "COMM ASSOC MGR",
                "COSMO",
                "MASSAGE LICENSING BD",
                "PROF. ENGINEER",
                "STRUCTURAL ENGINEER",
                "ARCHITECT",
                "LANDSCAPE ARCHITECT",
                "INTERIOR DESIGN",
                "LAND SURVEYOR BOARD",
                "HOME INSPECTOR",
                "ROOFING CONTRACTOR",
                "PUBLIC ACCOUNTANT",
                "COLLECTION AGENCY",
                "SOCIAL WORKER",
                "PROF. COUNSELOR",
                "CLIN PSYCHOLOGIST",
                "MAR AND FAM THERAPIST",
                "PHYSICAL THERAPY",
                "OCCUPATIONAL THERAPY",
                "SPEECH-LANGUAGE PATH",
                "RESPIRATORY CARE",
                "OPTOMETRY",
                "PODIATRY",
                "DIETETIC AND NUTRITION",
                "ATHLETIC TRAINER",
                "VETERINARY",
                "FUNERAL AND EMBALMER",
                "DETECTIVE BOARD",
                "AUCTIONEER",
                "SHORTHAND REPORTER",
                "ACUPUNCTURE",
                "NAPRAPATHY",
                "GEOLOGY",
                "ADULT USE CANNABIS BD",
                "MEDICAL CANNABIS BD"
              ],
              "enumTitles": [
                "Pharmacy (pharmacists & technicians)",
                "Nursing (RN, LPN)",
                "Advanced Practice Nurse (APN / NP)",
                "Physicians & Medical Board",
                "Physician Assistant",
                "Dental (dentists & hygienists)",
                "Real Estate (brokers & salespersons)",
                "Real Estate Appraisal",
                "Community Association Manager",
                "Cosmetology & Barber",
                "Massage Therapy",
                "Professional Engineer (PE)",
                "Structural Engineer (SE)",
                "Architect",
                "Landscape Architect",
                "Interior Design",
                "Land Surveyor",
                "Home Inspector",
                "Roofing Contractor",
                "Public Accountant (CPA)",
                "Collection Agency",
                "Social Worker (LSW / LCSW)",
                "Professional Counselor (LPC / LCPC)",
                "Clinical Psychologist",
                "Marriage & Family Therapist",
                "Physical Therapy",
                "Occupational Therapy",
                "Speech-Language Pathology",
                "Respiratory Care",
                "Optometry",
                "Podiatry",
                "Dietetics & Nutrition",
                "Athletic Trainer",
                "Veterinary",
                "Funeral Director & Embalmer",
                "Private Detective / Security",
                "Auctioneer",
                "Court / Shorthand Reporter",
                "Acupuncture",
                "Naprapathy",
                "Geology",
                "Adult-Use Cannabis",
                "Medical Cannabis"
              ]
            },
            "default": []
          },
          "statusFilter": {
            "title": "License Status",
            "enum": [
              "all",
              "active_only",
              "inactive_only"
            ],
            "type": "string",
            "description": "Show every record, only currently ACTIVE licenses, or only inactive ones (not renewed, expired, revoked, suspended, deceased, etc.).",
            "default": "all"
          },
          "counties": {
            "title": "County",
            "type": "array",
            "description": "Narrow results to one or more Illinois counties. Leave empty for statewide (and out-of-state) results.",
            "items": {
              "type": "string",
              "enum": [
                "COOK",
                "DUPAGE",
                "LAKE",
                "WILL",
                "KANE",
                "WINNEBAGO",
                "SANGAMON",
                "MCHENRY",
                "MADISON",
                "SAINT CLAIR",
                "PEORIA",
                "CHAMPAIGN",
                "MCLEAN",
                "TAZEWELL",
                "ROCK ISLAND",
                "KANKAKEE",
                "DEKALB",
                "MACON",
                "ADAMS",
                "VERMILION"
              ],
              "enumTitles": [
                "Cook (Chicago)",
                "DuPage",
                "Lake",
                "Will",
                "Kane",
                "Winnebago (Rockford)",
                "Sangamon (Springfield)",
                "McHenry",
                "Madison",
                "St. Clair",
                "Peoria",
                "Champaign",
                "McLean (Bloomington)",
                "Tazewell",
                "Rock Island",
                "Kankakee",
                "DeKalb",
                "Macon (Decatur)",
                "Adams (Quincy)",
                "Vermilion (Danville)"
              ]
            },
            "default": []
          },
          "cities": {
            "title": "City",
            "type": "array",
            "description": "Narrow results to one or more cities. Leave empty for all cities.",
            "items": {
              "type": "string",
              "enum": [
                "CHICAGO",
                "SPRINGFIELD",
                "ROCKFORD",
                "NAPERVILLE",
                "PEORIA",
                "AURORA",
                "JOLIET",
                "EVANSTON",
                "DES PLAINES",
                "OAK LAWN",
                "ARLINGTON HEIGHTS",
                "SKOKIE",
                "ELGIN",
                "DECATUR",
                "SCHAUMBURG",
                "OAK PARK",
                "DOWNERS GROVE",
                "BELLEVILLE",
                "CHAMPAIGN",
                "ORLAND PARK"
              ],
              "enumTitles": [
                "Chicago",
                "Springfield",
                "Rockford",
                "Naperville",
                "Peoria",
                "Aurora",
                "Joliet",
                "Evanston",
                "Des Plaines",
                "Oak Lawn",
                "Arlington Heights",
                "Skokie",
                "Elgin",
                "Decatur",
                "Schaumburg",
                "Oak Park",
                "Downers Grove",
                "Belleville",
                "Champaign",
                "Orland Park"
              ]
            },
            "default": []
          },
          "disciplineFilter": {
            "title": "Discipline History",
            "enum": [
              "all",
              "clean_only",
              "disciplined_only"
            ],
            "type": "string",
            "description": "Keep every record, only clean licensees with no disciplinary history, or only those who have been disciplined at some point.",
            "default": "all"
          },
          "descriptions": {
            "title": "Sub-type / Description (advanced)",
            "type": "array",
            "description": "Optional. Refine within a profession by exact description, e.g. 'PHARMACIST', 'REGISTERED NURSE', 'PHARMACY TECHNICIAN'. Leave empty to include all sub-types.",
            "items": {
              "type": "string"
            }
          },
          "issuedAfter": {
            "title": "Issued After Date (advanced)",
            "type": "string",
            "description": "Optional. Only return licenses originally issued after this date. Format: YYYY-MM-DD. Leave empty for all dates."
          },
          "maxRecords": {
            "title": "Max Records",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of records to return. Set 0 for unlimited (the full dataset is 1.2M+ records). A value like 100 keeps runs fast and cheap.",
            "default": 100
          },
          "pageSize": {
            "title": "Page Size (advanced)",
            "minimum": 100,
            "maximum": 50000,
            "type": "integer",
            "description": "Records fetched per API request. Higher values mean fewer requests but more memory. The default is fine for most runs.",
            "default": 1000
          },
          "requestDelay": {
            "title": "Request Delay ms (advanced)",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Delay between API requests in milliseconds. The default keeps you comfortably within rate limits.",
            "default": 300
          },
          "proxyConfiguration": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Optional proxy settings. Usually not needed for this data source."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}