{
  "openapi": "3.0.1",
  "info": {
    "title": "Miami-Dade Property Records API: Address, Flood Zone, Permits",
    "description": "Miami-Dade property data API. Look up any address or folio, or search by ZIP, sale date and owner type: beds, baths, value, last sale, FEMA flood zone, permits, violations and a 0-100 lead score. Clean JSON in seconds, no login or proxy.",
    "version": "0.0",
    "x-build-id": "mV7iDcG2aLqKHw7fM"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/open-records-data~miami-dade-property-records/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-open-records-data-miami-dade-property-records",
        "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/open-records-data~miami-dade-property-records/runs": {
      "post": {
        "operationId": "runs-sync-open-records-data-miami-dade-property-records",
        "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/open-records-data~miami-dade-property-records/run-sync": {
      "post": {
        "operationId": "run-sync-open-records-data-miami-dade-property-records",
        "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": {
          "addresses": {
            "title": "Addresses to look up",
            "type": "array",
            "description": "Street addresses in Miami-Dade County, e.g. \"1111 Brickell Ave, Miami, FL 33131\" or \"500 Alton Rd #901\". Spelling variants (Southwest / SW, 48th / 48) are handled. For a condo, include the unit. When you provide addresses or folios, the search filters below are ignored.",
            "items": {
              "type": "string"
            }
          },
          "folios": {
            "title": "Folio numbers to look up",
            "type": "array",
            "description": "13-digit Miami-Dade folio (parcel) numbers, with or without dashes, e.g. 01-4115-023-0110.",
            "items": {
              "type": "string"
            }
          },
          "zipCodes": {
            "title": "ZIP codes (any match)",
            "type": "array",
            "description": "Search properties in these 5-digit ZIP codes, e.g. 33133, 33139.",
            "items": {
              "type": "string"
            }
          },
          "cities": {
            "title": "Cities (any match)",
            "type": "array",
            "description": "Search by the county's city name, e.g. Miami, Miami Beach, Coral Gables, Hialeah, Homestead, Doral. Exact names, any capitalisation.",
            "items": {
              "type": "string"
            }
          },
          "propertyTypes": {
            "title": "Property types (any match)",
            "type": "array",
            "description": "Florida land-use groups. Leave empty for all types.",
            "items": {
              "type": "string",
              "enum": [
                "single-family",
                "condo",
                "multifamily",
                "mobile-home",
                "vacant-land",
                "commercial",
                "industrial",
                "agricultural",
                "institutional-government"
              ],
              "enumTitles": [
                "Single-family homes",
                "Condominium units",
                "Multi-family / apartments",
                "Mobile homes",
                "Vacant land",
                "Commercial (stores, offices, hotels)",
                "Industrial / warehouse",
                "Agricultural",
                "Institutional, government, utilities"
              ]
            }
          },
          "soldWithinDays": {
            "title": "Sold within the last N days",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Only properties whose most recent recorded sale is in this window. The county roll keeps the latest sale per parcel. Leave empty for no sale filter (with no other search filters, the last 30 days are used)."
          },
          "minSalePrice": {
            "title": "Minimum sale price ($)",
            "minimum": 0,
            "type": "integer",
            "description": "Latest recorded sale price at or above this amount."
          },
          "maxSalePrice": {
            "title": "Maximum sale price ($)",
            "minimum": 0,
            "type": "integer",
            "description": "Latest recorded sale price at or below this amount (nominal $1-$100 transfers are included unless you exclude them)."
          },
          "excludeNominalSales": {
            "title": "Exclude nominal transfers",
            "type": "boolean",
            "description": "Skip sales of $100 or less (gifts, quitclaims, entity changes) so only priced sales remain.",
            "default": false
          },
          "yearBuiltMin": {
            "title": "Built in or after",
            "minimum": 1700,
            "maximum": 2100,
            "type": "integer",
            "description": "Earliest year built."
          },
          "yearBuiltMax": {
            "title": "Built in or before",
            "minimum": 1700,
            "maximum": 2100,
            "type": "integer",
            "description": "Latest year built. Useful for older housing stock, e.g. 1985."
          },
          "minAssessedValue": {
            "title": "Minimum assessed value ($)",
            "minimum": 0,
            "type": "integer",
            "description": "County assessed value at or above this amount."
          },
          "maxAssessedValue": {
            "title": "Maximum assessed value ($)",
            "minimum": 0,
            "type": "integer",
            "description": "County assessed value at or below this amount."
          },
          "minBedrooms": {
            "title": "Minimum bedrooms",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "At least this many bedrooms."
          },
          "minLivingArea": {
            "title": "Minimum living area (sq ft)",
            "minimum": 0,
            "type": "integer",
            "description": "Heated building area at or above this size."
          },
          "minLotSize": {
            "title": "Minimum lot size (sq ft)",
            "minimum": 0,
            "type": "integer",
            "description": "Lot size at or above this size."
          },
          "absenteeOwnersOnly": {
            "title": "Absentee owners only",
            "type": "boolean",
            "description": "Keep properties whose owner's mailing address differs from the property (landlords, second-home and investor owners). Widens the internal search to find enough matches.",
            "default": false
          },
          "entityOwnersOnly": {
            "title": "Company owners only",
            "type": "boolean",
            "description": "Keep properties owned by an LLC, corporation or similar company or government body (individuals and trusts are excluded).",
            "default": false
          },
          "outOfStateOwnersOnly": {
            "title": "Out-of-state or foreign owners only",
            "type": "boolean",
            "description": "Keep properties whose owner mails from another state or country.",
            "default": false
          },
          "specialFloodHazardOnly": {
            "title": "FEMA special flood hazard areas only",
            "type": "boolean",
            "description": "Keep only properties inside a FEMA Special Flood Hazard Area (zones A, AE, AH, AO, V, VE ...). Turns on enrichment, so records are billed at the enriched rate.",
            "default": false
          },
          "minScore": {
            "title": "Minimum prospecting score",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Keep only properties scoring at least this (0-100). Turns on enrichment, so records are billed at the enriched rate."
          },
          "enrich": {
            "title": "Enrich: flood zone, permits, violations, score",
            "type": "boolean",
            "description": "Adds the FEMA flood zone and base flood elevation, recent building permits (roof, electrical, ...), open code and building violations, plain-English signals and a 0-100 prospecting score with reasons. Sorted best first in search mode. Billed at the higher enriched-record rate.",
            "default": false
          },
          "requireAddress": {
            "title": "Require a street address",
            "type": "boolean",
            "description": "Skip parcels without a site address (search mode).",
            "default": true
          },
          "maxUnitsPerAddress": {
            "title": "Max units per address",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "When a lookup address is a condo building or multi-unit parcel and you give no unit, return at most this many units.",
            "default": 10
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Upper bound on records returned and billed. Your run's maximum-charge setting is honoured too, so you can never be billed more than you set.",
            "default": 25
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}