{
  "openapi": "3.0.1",
  "info": {
    "title": "Texas Department of Insurance License Scraper",
    "description": "Extract Texas Department of Insurance license records: 950K+ agents and 55K+ agencies with license numbers, NPN, types, status, dates, and locations. Filter by license type, city, or ZIP.",
    "version": "0.1",
    "x-build-id": "iLNeXx5t3chel7Vak"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/parseforge~tdi-texas-insurance-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-parseforge-tdi-texas-insurance-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/parseforge~tdi-texas-insurance-scraper/runs": {
      "post": {
        "operationId": "runs-sync-parseforge-tdi-texas-insurance-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/parseforge~tdi-texas-insurance-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-parseforge-tdi-texas-insurance-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": {
          "maxItems": {
            "title": "Max Items",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
          },
          "dataset": {
            "title": "Dataset",
            "enum": [
              "agents",
              "agencies"
            ],
            "type": "string",
            "description": "Which TDI record set to scrape. Agents includes individual agents and adjusters. Agencies includes corporate licensees and businesses.",
            "default": "agents"
          },
          "licenseTypeAgent": {
            "title": "License type (agents)",
            "enum": [
              "",
              "General Lines Agent",
              "Adjuster",
              "Life Agent",
              "Pers Lines Prop and Cas Agent",
              "Adjuster - DHS Texas",
              "Surplus Lines Agent",
              "Escrow Officer",
              "Limited Lines Agent",
              "Pre-Need Agent",
              "County Mutual Agent",
              "Public Insurance Adjuster",
              "Life Agt Not Exceeding $25,000",
              "Managing General Agent",
              "Temp General Lines - LAH Agent",
              "Risk Manager",
              "Specialty Insurance Agent",
              "Life Stlmt Bkr Regr - Life Agt",
              "Temporary Life Agent",
              "Life Stlmnt Broker",
              "Reinsurance Broker",
              "Temp General Lines - P&C Agent",
              "Reinsurance Manager",
              "Temp. Pers Lines Prop and Cas",
              "Temporary Pre-Need Agent",
              "Temporary Limited Lines Agent",
              "Temporary County Mutual Agent",
              "Temp Gen Lines- Emer P&C Agent",
              "Life Stlmnt LE Estimator",
              "Temp Life Ins Not Exceed $25K"
            ],
            "type": "string",
            "description": "Filter agent records by license type. Leave blank to include all types. Only applies when dataset is 'agents'.",
            "default": ""
          },
          "licenseTypeAgency": {
            "title": "License type (agencies)",
            "enum": [
              "",
              "General Lines Agency",
              "Life Agency",
              "Surplus Lines Agency",
              "Specialty Insurance Agency",
              "Pers Lines Prop and Cas Agency",
              "Title Agency",
              "Managing General Agency",
              "Adjuster",
              "Public Insurance Adjuster",
              "Limited Lines Agency",
              "Reinsurance Broker",
              "Risk Manager Agency",
              "Discount Hthcare Prgm Oper Reg",
              "Life Stlmnt Broker",
              "Reinsurance Manager",
              "Pre-Need Agency",
              "Life Stlmnt Provider",
              "Title Direct Operations",
              "County Mutual Agency",
              "Life Stlmnt LE Estimator",
              "LI Agy Not Exceeding $25,000"
            ],
            "type": "string",
            "description": "Filter agency records by license type. Leave blank to include all types. Only applies when dataset is 'agencies'.",
            "default": ""
          },
          "state": {
            "title": "State",
            "enum": [
              "",
              "TX",
              "FL",
              "CA",
              "GA",
              "OH",
              "IL",
              "AZ",
              "NY",
              "MA",
              "PA",
              "NC",
              "CO",
              "AL",
              "AK",
              "AR",
              "CT",
              "DC",
              "DE",
              "HI",
              "IA",
              "ID",
              "IN",
              "KS",
              "KY",
              "LA",
              "MD",
              "ME",
              "MI",
              "MN",
              "MO",
              "MS",
              "MT",
              "ND",
              "NE",
              "NH",
              "NJ",
              "NM",
              "NV",
              "OK",
              "OR",
              "RI",
              "SC",
              "SD",
              "TN",
              "UT",
              "VA",
              "VT",
              "WA",
              "WI",
              "WV",
              "WY",
              "PR",
              "VI",
              "GU",
              "AS",
              "MP"
            ],
            "type": "string",
            "description": "Filter by licensee mailing address state. Leave blank to include all states.",
            "default": ""
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "Filter by city (exact match, case insensitive). Example: HOUSTON"
          },
          "postalCode": {
            "title": "Postal code",
            "type": "string",
            "description": "Filter by postal code prefix. Example: 770 returns all Houston-area ZIPs starting with 770."
          },
          "nameContains": {
            "title": "Name contains",
            "type": "string",
            "description": "Filter by substring match on the licensee name (case insensitive). Example: SMITH"
          },
          "licenseNumber": {
            "title": "License number",
            "type": "string",
            "description": "Look up a single license by Texas license number. Example: 3340665"
          },
          "npn": {
            "title": "NPN",
            "type": "string",
            "description": "Look up a single licensee by National Producer Number. Example: 7352575"
          },
          "activeOnly": {
            "title": "Active licenses only",
            "type": "boolean",
            "description": "If true, only return records whose expiration date is in the future. If false, includes expired licenses.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}