{ "openapi": "3.0.1", "info": { "title": "County Records & Property Owner Phone Lookup (Miami, NYC, LA)", "description": "Property owner lookup from official county records in Miami-Dade, New York City and Los Angeles: owner, mailing address, values, homestead, sales history, NYC deeds and mortgages, plus owner phones and e-mails (option). Search by address, owner name or parcel, or list a whole county with filters.", "version": "0.0", "x-build-id": "hXfR7LZWXNdtvUgqv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nice_dev~us-county-property-records-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nice_dev-us-county-property-records-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/nice_dev~us-county-property-records-scraper/runs": { "post": { "operationId": "runs-sync-nice_dev-us-county-property-records-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/nice_dev~us-county-property-records-scraper/run-sync": { "post": { "operationId": "run-sync-nice_dev-us-county-property-records-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": [ "counties" ], "properties": { "counties": { "title": "Counties", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Where to search. A lookup that names another county (state, ZIP code or city in the address) is only run there; the others are run in every county picked here. Los Angeles: the county does not publish owner names online, so owner names, mailing addresses and owner-name search are not available there.", "items": { "type": "string", "enum": [ "miami-dade", "new-york-city", "los-angeles" ], "enumTitles": [ "Miami-Dade County, FL", "New York City, NY (5 boroughs)", "Los Angeles County, CA" ] }, "default": [ "miami-dade" ] }, "addresses": { "title": "Addresses", "maxItems": 1000, "uniqueItems": true, "type": "array", "description": "Street addresses to look up, one per line, with the unit for an apartment (e.g. `1200 Brickell Bay Dr Unit 3101, Miami, FL 33131`, `350 W 50th St Apt 12B, New York, NY 10019`, `1000 Main St, Los Angeles, CA 90012`). One record per property found. Max 1 000.", "default": [], "items": { "type": "string" } }, "ownerNames": { "title": "Owner names", "maxItems": 500, "uniqueItems": true, "type": "array", "description": "Owner names to look up (person or company, e.g. `SMITH JOHN`, `ACME HOLDINGS LLC`): every property the name holds in the county. Word order does not matter (`JOHN SMITH` works too; New York City writes people `SMITH, JOHN`). Not available in Los Angeles. Max 500.", "default": [], "items": { "type": "string" } }, "parcelNumbers": { "title": "Parcel numbers", "maxItems": 1000, "uniqueItems": true, "type": "array", "description": "Miami-Dade folio (13 digits, dashes allowed: `02-4210-018-0050`; 9 digits = a whole building or subdivision: `024210018`), New York City BBL (10 digits, dashes allowed: `NYC:1-01030-1001`), Los Angeles AIN (10 digits, dashes allowed: `LA:4371-024-013`). Both NYC and LA use 10 digits: when both counties are picked, write NYC: or LA: before the number. Max 1 000.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max records", "minimum": 0, "maximum": 3000000, "type": "integer", "description": "Maximum number of property records to save for the whole run (after deduplication and filters). 0 = no limit. With the three lists above empty, the run lists the whole county: Miami-Dade has 943 550 parcels, New York City 1.18 million lots and apartments, Los Angeles 2.43 million parcels.", "default": 100 }, "maxItemsPerQuery": { "title": "Max records per search", "minimum": 0, "maximum": 3000000, "type": "integer", "description": "Cap for EACH search (one address, owner name or parcel in one county, or one whole-county listing), so that one big owner or county cannot use up the whole **Max records** budget. 0 = no per-search cap.", "default": 0 }, "includeDetails": { "title": "Full record", "type": "boolean", "description": "Read the full record of each property (1-4 extra requests): all recorded sales with buyer, seller and deed reference, 3 years of values, exemptions (homestead), New York City deeds and mortgages. Off by default = the fields of the county's search or open-data row only (owner, mailing address, last sale, current value): faster, and you skip the extra 'Full county record' fee of each property (see the Pricing tab). Tick it to get the full record. An address, owner or parcel lookup with a filter other than owner type, excluded words or borough reads the full record anyway (its search rows carry no sale, value or type).", "default": false }, "includeOwnerContacts": { "title": "Add the owner's phones and e-mails", "type": "boolean", "description": "For each property owned by a person (not a company or a government body), looks the owner up in public people-search directories: phones, e-mails, current address, age, relatives, and whether the person passed away (`ownerDeceased`: an owner still on the county's roll, an estate, when the directory says it); `ownerContactSource` says which directory gave the contact. Searched at the property first (the people listed there), then at the owner's mailing address, then by name in the state; `ownerContactMatch` says how the person was found (`address`, `mailing`, or `name` = name and state, kept only when the property or the owner's mailing address is among the person's known addresses). Miami-Dade and New York City (Los Angeles publishes no owner names). Needs 'Full record'. Slower (10-60 s per property). Charged as a separate `owner-contact` event, only for properties where a phone or an e-mail is found, whichever directory gives it.", "default": false }, "includeOwnerPortfolio": { "title": "Add the owner's other properties", "type": "boolean", "description": "For each property, lists the other properties its owner (the first owner named) holds in the same county: parcel, address, value and link to the county's record, up to 100. A namesake's property is never listed: a registered business (LLC, Inc., Corp., LP…) is matched by its exact name, anyone else (a person, a trust) only when the other property's owner address is this property or its mailing address. Miami-Dade (mailing address of every parcel) and New York City (valuation roll, and for a person the buyer's address on the deeds); not possible in Los Angeles (the county publishes no owner names). Needs 'Full record'. 1 to 3 more county requests per property. Priced separately (event `owner-portfolio`), only for properties where at least one other property is found.", "default": false }, "includeDistressScore": { "title": "Add a distress score (motivated seller)", "type": "boolean", "description": "For each property, a 0-100 score of signs that its owner may sell, computed from the county's own fields — no extra request, no AI model: owner deceased (needs 'Owner contacts'), owned by an estate or heirs, taken by a foreclosure deed in the last 3 years (bank-owned), owner not living there, owner out of state, owned for 10+ years, value 1.5× or 2× the last sale price, vacant land. Each factor found comes with its points and the value that set it off (distressFactors); the factors a row could not check are listed (distressUnchecked). Tax arrears are not read. Los Angeles publishes no owner names and its values are Proposition 13 bases: only 4 factors there. Works with or without 'Full record' (fewer factors without it). Priced separately (event `distress-score`), only for properties with at least one factor found; a score of 0 is free.", "default": false }, "sortBy": { "title": "Sort (whole-county listing)", "enum": [ "newestSale", "highestSalePrice", "highestValue", "parcel" ], "type": "string", "description": "Order of a whole-county listing: newest sales first, highest sale price, highest market value, or parcel number. Each county sorts on what it publishes: Miami-Dade's highest value is the assessed value; Los Angeles knows the year of the last sale only, so both sale orders give the most recent year first; New York City without a sale filter lists by parcel number (the valuation roll has no sales), and with a sale filter by newest deed. Lookups keep the county's order.", "default": "newestSale" }, "soldAfter": { "title": "Sold after", "type": "string", "description": "Only properties whose LAST recorded sale is on or after this date: `2026-01-01`, or a period before now such as `30 days`, `3 months`, `1 year`. Properties without a recorded sale are dropped. Los Angeles publishes the year of the last sale only: compared on the year." }, "soldBefore": { "title": "Sold before", "type": "string", "description": "Only properties whose last recorded sale is on or before this date (the whole day is included), or older than a period such as `10 years`." }, "minSalePrice": { "title": "Min last sale price ($)", "minimum": 0, "maximum": 10000000000, "type": "integer", "description": "Only properties whose last recorded sale price is at least this amount, in US dollars. Properties without a sale price are dropped." }, "maxSalePrice": { "title": "Max last sale price ($)", "minimum": 0, "maximum": 10000000000, "type": "integer", "description": "Only properties whose last recorded sale price is at most this amount, in US dollars." }, "minValue": { "title": "Min market value ($)", "minimum": 0, "maximum": 10000000000, "type": "integer", "description": "Only properties whose current market value set by the county is at least this amount (Miami-Dade: assessed value in the open data, market value in the full record; Los Angeles: land + improvement roll value)." }, "maxValue": { "title": "Max market value ($)", "minimum": 0, "maximum": 10000000000, "type": "integer", "description": "Only properties whose current market value is at most this amount." }, "propertyTypes": { "title": "Property types", "uniqueItems": true, "type": "array", "description": "Only these property types (any of them), from the county's land-use code. Empty = all types.", "items": { "type": "string", "enum": [ "singleFamily", "condo", "multiFamily", "commercial", "industrial", "land", "other" ], "enumTitles": [ "Single-family home", "Condo / co-op unit", "Multi-family (2+ units)", "Commercial / office / retail", "Industrial / warehouse", "Vacant land", "Other (government, religious, agricultural…)" ] }, "default": [] }, "ownerType": { "title": "Owner type", "enum": [ "any", "company", "individual" ], "type": "string", "description": "Companies (LLC, Inc., LP, trust, estate…) only, people only, or both. Read on the owner name. Not available in Los Angeles.", "default": "any" }, "absenteeOwnersOnly": { "title": "Absentee owners only", "type": "boolean", "description": "Only properties whose owner's mailing address is not the property address (rented, second home, investor). New York City: mailing address = buyer's address on the last deed (full record needed). Not available in Los Angeles.", "default": false }, "outOfStateOwnersOnly": { "title": "Out-of-state owners only", "type": "boolean", "description": "Only properties whose owner's mailing address is in another US state or abroad.", "default": false }, "foreignOwnersOnly": { "title": "Foreign owners only", "type": "boolean", "description": "Only properties whose owner's mailing address is outside the United States.", "default": false }, "homesteadOnly": { "title": "Primary residences only", "type": "boolean", "description": "Only properties with a homestead / homeowners' exemption (the owner lives there). Miami-Dade: read in the full record. Not available in New York City.", "default": false }, "excludeHomestead": { "title": "Exclude primary residences", "type": "boolean", "description": "Drop the properties with a homestead / homeowners' exemption (keeps rentals, second homes and investor-owned properties). Not available in New York City.", "default": false }, "zipCodes": { "title": "ZIP codes", "maxItems": 500, "uniqueItems": true, "type": "array", "description": "Only properties in these 5-digit ZIP codes (e.g. `33109`). Empty = the whole county.", "default": [], "items": { "type": "string" } }, "boroughs": { "title": "New York City boroughs", "uniqueItems": true, "type": "array", "description": "New York City only: only these boroughs. Empty = the 5 boroughs.", "items": { "type": "string", "enum": [ "manhattan", "bronx", "brooklyn", "queens", "staten-island" ], "enumTitles": [ "Manhattan", "Bronx", "Brooklyn", "Queens", "Staten Island" ] }, "default": [] }, "latitude": { "title": "Around: latitude", "maxLength": 20, "type": "string", "description": "Whole-county listing around a point: latitude in decimal degrees (e.g. `25.7617`), with **Around: longitude** and **Radius**. Miami-Dade and Los Angeles only (the New York City valuation data has no coordinates)." }, "longitude": { "title": "Around: longitude", "maxLength": 20, "type": "string", "description": "Longitude in decimal degrees (e.g. `-80.1918`)." }, "radiusMiles": { "title": "Radius (miles)", "minimum": 0.1, "maximum": 50, "type": "number", "description": "Distance around the point, in miles (0.1 to 50)." }, "minYearBuilt": { "title": "Built from (year)", "minimum": 1600, "maximum": 2100, "type": "integer", "description": "Only buildings built in or after this year." }, "maxYearBuilt": { "title": "Built until (year)", "minimum": 1600, "maximum": 2100, "type": "integer", "description": "Only buildings built in or before this year." }, "minBedrooms": { "title": "Min bedrooms", "minimum": 0, "maximum": 50, "type": "integer", "description": "Only properties with at least this many bedrooms. Not available in New York City (the city does not publish bedrooms)." }, "maxBedrooms": { "title": "Max bedrooms", "minimum": 0, "maximum": 50, "type": "integer", "description": "Only properties with at most this many bedrooms. Not available in New York City." }, "minBathrooms": { "title": "Min bathrooms", "minimum": 0, "maximum": 50, "type": "integer", "description": "Only properties with at least this many full bathrooms. Not available in New York City." }, "maxBathrooms": { "title": "Max bathrooms", "minimum": 0, "maximum": 50, "type": "integer", "description": "Only properties with at most this many full bathrooms. Not available in New York City." }, "minLivingAreaSqFt": { "title": "Min living area (sq ft)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Only properties with at least this living area, in square feet (New York City: gross building area)." }, "maxLivingAreaSqFt": { "title": "Max living area (sq ft)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Only properties with at most this living area, in square feet." }, "minLotSizeSqFt": { "title": "Min lot size (sq ft)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Only properties whose land area is at least this many square feet (1 acre = 43 560 sq ft)." }, "maxLotSizeSqFt": { "title": "Max lot size (sq ft)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Only properties whose land area is at most this many square feet." }, "poolOnly": { "title": "With a pool only", "type": "boolean", "description": "Miami-Dade only: only properties whose full record lists a pool. Not available in New York City and Los Angeles (not published).", "default": false }, "excludeKeywords": { "title": "Exclude owner keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Drop the properties whose owner name contains one of these words (case ignored), e.g. `COUNTY`, `CITY OF`, `HOUSING AUTHORITY`.", "default": [], "items": { "type": "string" } }, "onlyNew": { "title": "Only new records", "type": "boolean", "description": "Skip the properties that a previous run (same **Memory key**) already delivered, even if they were sold since: they are not saved and not charged, and their full record is not even read. First run = everything is new.", "default": false }, "stateKey": { "title": "Memory key", "pattern": "^[a-zA-Z0-9_-]{1,64}$", "maxLength": 64, "type": "string", "description": "Name of the memory used by **Only new records**. Give each schedule / task its own key (e.g. `miami-sales-1m`) so that they do not share their memory. Letters, digits, `-` and `_`.", "default": "default" }, "resetState": { "title": "Reset the memory", "type": "boolean", "description": "Forget everything remembered under this **Memory key** before the run: this run returns (and charges) every record again. Untick it afterwards.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy or your own proxies. Keep the default: it is included in the price. The residential Apify proxy is not available in this Actor.", "default": { "useApifyProxy": true } }, "socrataAppToken": { "title": "NYC Open Data app token", "type": "string", "description": "Optional, New York City only: your free app token from data.cityofnewyork.us (Developer settings). It raises the open-data rate limit for very large runs. Stored encrypted." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of requests processed in parallel.", "default": 4 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 10, "maximum": 600, "type": "integer", "description": "Most requests to the county servers in any 60 seconds, all of them counted. A budget, not an even pace (spread them with the minimum delay below). Lower it if the log shows HTTP 429 / 403.", "default": 120 }, "minRequestIntervalMs": { "title": "Min delay between requests", "minimum": 0, "maximum": 60000, "type": "integer", "description": "Smallest gap between two requests, in milliseconds. Unlike the per-minute rate, this spreads the requests evenly instead of letting them go out in a burst. 0 = no gap.", "default": 0 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 20, "type": "integer", "description": "Retries per request before it is marked as failed. Behind a proxy, a request the server turns away is also retried on a new proxy session up to 10 times without using up these retries.", "default": 5 }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Include debug messages in the run log.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }