{
  "openapi": "3.0.1",
  "info": {
    "title": "Ohio eLicense Scraper",
    "description": "Look up Ohio professional and occupational licenses issued by the Ohio Department of Commerce's Division of Real Estate & Professional Licensing. Search by license number, name, business name, or license type. Get status, issue/expiration dates, and address.",
    "version": "1.0",
    "x-build-id": "gg4g3spRD8FCeaTsJ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/crawlerbros~ohio-elicense-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-crawlerbros-ohio-elicense-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/crawlerbros~ohio-elicense-scraper/runs": {
      "post": {
        "operationId": "runs-sync-crawlerbros-ohio-elicense-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/crawlerbros~ohio-elicense-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-crawlerbros-ohio-elicense-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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Search mode",
            "enum": [
              "byLicenseType",
              "byLicenseNumber",
              "byName",
              "byBusinessName",
              "byCity"
            ],
            "type": "string",
            "description": "Choose how to search Ohio's Division of Real Estate & Professional Licensing records.",
            "default": "byLicenseType"
          },
          "licenseTypePrefix": {
            "title": "License type (mode=byLicenseType, byLicenseNumber)",
            "enum": [
              "",
              "ACG",
              "ACGO",
              "ACGR",
              "ACGT",
              "ACR",
              "ACRO",
              "ACRR",
              "ACRT",
              "ALR",
              "ALRO",
              "ALRR",
              "ALRT",
              "AMC",
              "ARA",
              "BBB",
              "BRK",
              "BRKA",
              "BRKM",
              "BRKP",
              "CBR",
              "CEO",
              "CGR",
              "CRC",
              "FPR",
              "FRC",
              "FRDC",
              "FRDI",
              "FRS",
              "HICE",
              "HIQE",
              "LPR",
              "OHI",
              "REC",
              "RECE",
              "SAL",
              "SALM",
              "SOLE"
            ],
            "type": "string",
            "description": "Ohio REPL credential/license type. Required for `byLicenseNumber` and `byLicenseType`; optional narrowing filter for other modes.",
            "default": ""
          },
          "licenseNumber": {
            "title": "License number (mode=byLicenseNumber)",
            "type": "string",
            "description": "Numeric license identifier, without the type-prefix letters (e.g. `2019005678`). Requires `licenseTypePrefix`.",
            "default": ""
          },
          "licenseSuffix": {
            "title": "License suffix (mode=byLicenseNumber, optional)",
            "type": "string",
            "description": "Optional sub-category / branch-office suffix appended after the license number.",
            "default": ""
          },
          "firstName": {
            "title": "First name (mode=byName)",
            "type": "string",
            "description": "Licensee first name. At least one of `firstName` / `lastName` is required for `byName`.",
            "default": ""
          },
          "lastName": {
            "title": "Last name (mode=byName)",
            "type": "string",
            "description": "Licensee last name. At least one of `firstName` / `lastName` is required for `byName`.",
            "default": ""
          },
          "maidenName": {
            "title": "Maiden name (mode=byName, optional)",
            "type": "string",
            "description": "Optional maiden-name search field.",
            "default": ""
          },
          "businessName": {
            "title": "Business name / DBA (mode=byBusinessName)",
            "type": "string",
            "description": "Real estate corporation, brokerage, or appraisal-management-company name.",
            "default": ""
          },
          "address": {
            "title": "Street address (optional narrowing filter)",
            "type": "string",
            "description": "Optional street-address contains-filter.",
            "default": ""
          },
          "city": {
            "title": "City (mode=byCity, optional narrowing filter for other modes)",
            "type": "string",
            "description": "Licensee/business city. Required for `byCity`; optional narrowing filter for other modes.",
            "default": ""
          },
          "county": {
            "title": "County (optional narrowing filter)",
            "type": "string",
            "description": "Optional Ohio county exact-match filter (e.g. `Franklin`), matched against the licensee/business mailing address on file. Leave blank for all counties.",
            "default": ""
          },
          "zipCode": {
            "title": "Zip code (optional narrowing filter)",
            "type": "string",
            "description": "Optional 5-digit zip-code filter, matched against the licensee/business mailing address on file.",
            "default": ""
          },
          "state": {
            "title": "State / province (optional narrowing filter)",
            "enum": [
              "",
              "AL",
              "AK",
              "AB",
              "AS",
              "AP",
              "AZ",
              "AR",
              "AE",
              "BC",
              "CA",
              "CO",
              "CT",
              "DE",
              "DC",
              "FM",
              "FL",
              "GA",
              "GU",
              "HI",
              "ID",
              "IL",
              "IN",
              "IA",
              "KS",
              "KY",
              "LA",
              "ME",
              "MB",
              "MH",
              "MD",
              "MA",
              "MX",
              "MI",
              "MN",
              "MS",
              "MO",
              "MT",
              "NE",
              "NV",
              "NB",
              "NH",
              "NJ",
              "NM",
              "NY",
              "NF",
              "NC",
              "ND",
              "MP",
              "NT",
              "NS",
              "OH",
              "OK",
              "ON",
              "OR",
              "PW",
              "PA",
              "PE",
              "PR",
              "PQ",
              "RI",
              "SK",
              "SC",
              "SD",
              "TN",
              "TX",
              "UK",
              "UT",
              "VT",
              "VI",
              "VA",
              "WA",
              "WV",
              "WI",
              "WY",
              "YT"
            ],
            "type": "string",
            "description": "Two-letter US state or Canadian province code.",
            "default": ""
          },
          "status": {
            "title": "License status (optional narrowing filter, exact match)",
            "type": "string",
            "description": "Optional exact-match filter on the license status text as returned by Ohio REPL (e.g. `Active`, `Expired`). Leave blank for all statuses.",
            "default": ""
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Maximum number of license records to return.",
            "default": 20
          },
          "useApifyProxy": {
            "title": "Use Apify Proxy (datacenter)",
            "type": "boolean",
            "description": "Route the browser through Apify's free AUTO datacenter proxy group. Leave off unless you see 0 results and suspect an IP-based block.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}