{
  "openapi": "3.0.1",
  "info": {
    "title": "Texas Tow & VSF Insurance Leads — TDLR Renewal Dates",
    "description": "Every Texas tow company and vehicle storage facility with its CURRENT insurance on file at TDLR — carrier, policy type, effective/cancellation dates, fleet size, phone, and site address. Flags pending-cancellation and lapsed-coverage leads. ~5.7k certificates, refreshed daily. Free CRM sync.",
    "version": "1.0",
    "x-build-id": "YoFzhM8S1FoQCdNfR"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/deadwood_data_solutions~texas-tow-vsf-insurance-leads/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-deadwood_data_solutions-texas-tow-vsf-insurance-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/deadwood_data_solutions~texas-tow-vsf-insurance-leads/runs": {
      "post": {
        "operationId": "runs-sync-deadwood_data_solutions-texas-tow-vsf-insurance-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/deadwood_data_solutions~texas-tow-vsf-insurance-leads/run-sync": {
      "post": {
        "operationId": "run-sync-deadwood_data_solutions-texas-tow-vsf-insurance-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": {
          "facilityTypes": {
            "title": "Facility types (empty = both)",
            "type": "array",
            "description": "Which TDLR programs to pull. Values: towCompany (licensed tow companies, ~3.8k) and vehicleStorage (vehicle storage / impound facilities, ~1.9k). Leave empty for both.",
            "items": {
              "type": "string"
            }
          },
          "onlyLapsed": {
            "title": "Only businesses with lapsed insurance (hottest leads)",
            "type": "boolean",
            "description": "Return only certificate holders whose on-file policy has a cancellation date on or before today — i.e. currently uninsured. A Texas tow company or storage lot legally cannot operate without the required coverage, so these are the highest-intent replacement-insurance leads.",
            "default": false
          },
          "effectiveWithinDays": {
            "title": "Policy effective within the last N days",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Only holders whose current policy took effect within the last N days — newly insured or freshly renewed businesses (a shopping / switch window). Leave blank for all. About a third of the book has a policy effective in the current year."
          },
          "carriers": {
            "title": "Insurance carriers (empty = all)",
            "type": "array",
            "description": "Only holders whose current carrier name contains one of these (case-insensitive substring), e.g. PROGRESSIVE, NATIONAL LIABILITY. Use to target (or exclude by omission) a competitor's book of business. 120+ distinct carriers appear.",
            "items": {
              "type": "string"
            }
          },
          "minVehicleCount": {
            "title": "Minimum insured vehicle count (tow only)",
            "minimum": 1,
            "type": "integer",
            "description": "Only tow companies reporting at least this many insured vehicles — a proxy for fleet size and commercial-auto premium. Vehicle storage facilities do not report a vehicle count and are excluded when this is set above 0."
          },
          "cities": {
            "title": "Site cities (empty = all of Texas)",
            "type": "array",
            "description": "Only facilities whose physical site city matches (case-insensitive exact match, e.g. HOUSTON, DALLAS, SAN ANTONIO).",
            "items": {
              "type": "string"
            }
          },
          "counties": {
            "title": "Site counties (empty = all)",
            "type": "array",
            "description": "Only facilities whose physical site county matches (case-insensitive exact match, e.g. HARRIS, DALLAS, TARRANT).",
            "items": {
              "type": "string"
            }
          },
          "zipPrefixes": {
            "title": "Site ZIP prefixes (empty = all)",
            "type": "array",
            "description": "Only facilities whose site ZIP starts with one of these prefixes (e.g. 77 for greater Houston, 75 for Dallas, 787 for Austin).",
            "items": {
              "type": "string"
            }
          },
          "listLocationsOnly": {
            "title": "Discovery mode: list valid site cities & counties only (free)",
            "type": "boolean",
            "description": "Return the cities and counties actually present in the current TDLR extract — the exact values you can pass to 'Site cities' / 'Site counties' — then stop. No records normalized and nothing charged. Use this first to get spelling exactly right before spending on a real run.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum records to return",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many normalized leads have been pushed. Leave blank for no limit."
          },
          "onlyNewSinceLastRun": {
            "title": "Only return records not seen in a previous run",
            "type": "boolean",
            "description": "Recommended for scheduled runs. Uses persisted state keyed on certificate + policy effective + cancellation date, so a recurring schedule only charges for genuinely new certificates, policy renewals/changes and newly filed cancellations — not the unchanged book.",
            "default": true
          },
          "syncEnabled": {
            "title": "Sync new records to a connected app (optional)",
            "type": "boolean",
            "description": "Send each new record to a connected destination (Notion, HubSpot, Airtable, Supabase, or any Apify MCP connector) in addition to the dataset. Free — this never triggers a billable event. A sync failure never blocks or fails the run.",
            "default": false
          },
          "syncDestination": {
            "title": "Sync destination connector",
            "type": "string",
            "description": "Connect the app under Integrations in Apify Console first, then pick it here. Required only if 'Sync new records' is on."
          },
          "syncWriteTool": {
            "title": "Sync destination tool to call per record",
            "type": "string",
            "description": "Name of the destination's MCP tool that creates one record, e.g. 'create_page' for Notion, 'insert' for Supabase. Run the dataset-sync-connector Actor in 'list-tools' mode against the same destination if you don't know it."
          },
          "syncFieldMap": {
            "title": "Sync field mapping",
            "type": "object",
            "description": "Maps destination argument names to this Actor's output field names, e.g. {\"title\": \"legalName\", \"phone\": \"phone\"}. Leave empty to pass each record through unchanged."
          },
          "syncExtraArgs": {
            "title": "Sync constant arguments",
            "type": "object",
            "description": "Fixed arguments merged into every sync write call, e.g. {\"database_id\": \"abc123\"} for Notion."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}