{
  "openapi": "3.0.1",
  "info": {
    "title": "Florida Insurance Producer Leads — New & Unappointed Agents",
    "description": "Carriers just served involuntary suspension notices (insurance dropped) with ~100% phone and email, plus fresh policy filings and cancellations with insurer names. Daily.",
    "version": "0.1",
    "x-build-id": "FyN6qg5jMChU1Va9D"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/foxlabs~us-insurance-producer-leads/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-foxlabs-us-insurance-producer-leads",
        "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/foxlabs~us-insurance-producer-leads/runs": {
      "post": {
        "operationId": "runs-sync-foxlabs-us-insurance-producer-leads",
        "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/foxlabs~us-insurance-producer-leads/run-sync": {
      "post": {
        "operationId": "run-sync-foxlabs-us-insurance-producer-leads",
        "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": {
          "preset": {
            "title": "Lead preset",
            "enum": [
              "newly_licensed",
              "no_active_appointment",
              "search"
            ],
            "type": "string",
            "description": "Start here — each preset is a ready-made filter combination. 'Newly licensed' finds producers whose FIRST-EVER Florida licence was issued inside the date window (true new entrants, not veterans adding a class). 'Licensed but not appointed' additionally joins the state appointment files and keeps only producers with no active carrier appointment — the classic recruiting list. 'Search all licences' turns every filter over to you.",
            "default": "newly_licensed"
          },
          "datePreset": {
            "title": "Date range",
            "enum": [
              "last_30_days",
              "last_60_days",
              "last_90_days",
              "last_6_months",
              "last_12_months",
              "all_time",
              "custom"
            ],
            "type": "string",
            "description": "Which licence-issue dates count. With the 'Newly licensed' preset this is tested against the producer's first-ever licence. Defaults to the last 90 days for 'Newly licensed' and to all time for the other presets."
          },
          "issueDateFrom": {
            "title": "Issued from",
            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
            "type": "string",
            "description": "YYYY-MM-DD, e.g. 2026-01-01. Only used when Date range = Custom."
          },
          "issueDateTo": {
            "title": "Issued to",
            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
            "type": "string",
            "description": "YYYY-MM-DD. Only used when Date range = Custom. Leave empty for 'up to today'."
          },
          "firstTimeOnly": {
            "title": "First-ever licence only",
            "type": "boolean",
            "description": "ON (default for 'Newly licensed'): the date window must contain the producer's very first Florida licence, so you get genuine new entrants. OFF: any licence class issued in the window counts, which also surfaces experienced agents who just added a line."
          },
          "licenseCategories": {
            "title": "Licence categories",
            "type": "array",
            "description": "Plain-English groupings of Florida's 78 licence class codes. Leave empty for every class.",
            "items": {
              "type": "string",
              "enum": [
                "life_annuity",
                "health",
                "life_and_health",
                "property_casualty",
                "personal_lines",
                "adjuster",
                "public_adjuster",
                "customer_representative",
                "title",
                "bail_bond",
                "warranty",
                "travel",
                "credit",
                "preneed",
                "managing_general_agent"
              ],
              "enumTitles": [
                "Life & variable annuity (0214, 0216, 0219, 0814, 0816)",
                "Health (0240, 0840)",
                "Life & health combined (0215, 0218, 0815, 0818)",
                "Property & casualty / general lines (0220, 0920, 0120, 9120)",
                "Personal lines agent (2044, 9044)",
                "Adjuster — all lines & specialties (0620, 0720, 7020, …)",
                "Public adjuster (0320, 7320, …)",
                "Customer representative (0440, 0442, 0055)",
                "Title (0410, 9413)",
                "Bail bond / limited surety (0234, 0237)",
                "Service / home / auto warranty (0251, 0252, 0253)",
                "Travel insurance (0241, 0941)",
                "Credit insurance (0229, 0929)",
                "Preneed funeral (0224, 0924)",
                "Managing general agent & reinsurance intermediary (0060–0064)"
              ]
            },
            "default": []
          },
          "licenseTypeCodes": {
            "title": "Exact licence class codes (advanced)",
            "type": "array",
            "description": "Raw Florida TYCL codes, e.g. 0215, 0620, 0814. Combined with the categories above (a licence matching either is kept). Leave empty unless you need a class the categories do not isolate.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "licenseStatus": {
            "title": "Licence status",
            "enum": [
              "any",
              "valid",
              "valid_probation"
            ],
            "type": "string",
            "description": "The source file only contains valid licences: 99.98% are VALID and 0.02% are VALID - PROBATION (measured on 1.19 M rows). Use 'Probation only' to isolate that small compliance-risk group.",
            "default": "any"
          },
          "residentOnly": {
            "title": "Florida residents only",
            "type": "boolean",
            "description": "ON keeps resident licensees only. Roughly 59% of Florida licences are held by non-residents living in other states — useful reach, but resident producers are the ones most agencies recruit.",
            "default": false
          },
          "counties": {
            "title": "Florida counties",
            "type": "array",
            "description": "e.g. Dade, Broward, Hillsborough, Orange. 'Miami-Dade' is accepted and mapped to the register's spelling ('Dade'). Note: the county column is only populated for licensees with a Florida business address — 96% filled there, but blank for the 59% of licensees who live out of state, so combining this with non-residents returns little.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "cities": {
            "title": "Business cities",
            "type": "array",
            "description": "Exact business-address city names, e.g. MIAMI, ORLANDO, TAMPA. Case-insensitive. Leave empty for all.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "businessStates": {
            "title": "Business address states",
            "type": "array",
            "description": "Two-letter codes filtering the business address, e.g. FL, TX, NY. Useful to target non-resident Florida licensees living in a particular state. Leave empty for all.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "appointmentFilter": {
            "title": "Appointment status",
            "enum": [
              "any",
              "no_active_appointment",
              "has_active_appointment"
            ],
            "type": "string",
            "description": "Joins the state's active-appointment files (~1 GB, adds time to the run) and can filter on the result. 'No active appointment' is the recruiting list: licensed producers not currently appointed by any carrier. Leave on 'Do not join' for the fastest runs."
          },
          "requireEmail": {
            "title": "Only rows with an email",
            "type": "boolean",
            "description": "Drop producers without a valid email. Coverage is 99.99% on the raw file, so this rarely removes anything.",
            "default": false
          },
          "requirePhone": {
            "title": "Only rows with a phone",
            "type": "boolean",
            "description": "Drop producers without a usable 10-digit business phone (placeholder numbers such as 0000000000 never count as filled).",
            "default": false
          },
          "groupByLicensee": {
            "title": "One row per producer",
            "type": "boolean",
            "description": "ON (default): one row per person, with all their licence classes in a nested list — you are not billed for the same producer 1.27 times. OFF: one row per licence class, closer to the raw state file.",
            "default": true
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap on output rows. Set to 0 for unlimited — the full file holds ~937,000 producers across ~1.19 M licence rows.",
            "default": 1000
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}