{
  "openapi": "3.0.1",
  "info": {
    "title": "Recorded Deeds & Property Transfers Scraper (TX, OH, MI, NYC)",
    "description": "Recorded deeds by date from 92 county recorders (TX, OH, MI, NYC, Chicago): grantor, grantee, deed type, legal, parcel, sale price where recorded. New-owner and LLC-buyer lists.",
    "version": "0.0",
    "x-build-id": "5NmPe4cclj5kqAgPa"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapebench~county-recorded-deeds-by-date/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapebench-county-recorded-deeds-by-date",
        "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/scrapebench~county-recorded-deeds-by-date/runs": {
      "post": {
        "operationId": "runs-sync-scrapebench-county-recorded-deeds-by-date",
        "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/scrapebench~county-recorded-deeds-by-date/run-sync": {
      "post": {
        "operationId": "run-sync-scrapebench-county-recorded-deeds-by-date",
        "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": {
          "countyList": {
            "title": "Counties",
            "type": "array",
            "description": "Pick the counties to search. Every county here is covered; New York City's boroughs are New York (Manhattan), Kings (Brooklyn), Queens, Bronx and Richmond (Staten Island).",
            "items": {
              "type": "string",
              "enum": [
                "Garland, AR",
                "Arapahoe, CO",
                "Boulder, CO",
                "Pitkin, CO",
                "Routt, CO",
                "Sterling, CT",
                "Cook, IL",
                "Calhoun, MI",
                "Hillsdale, MI",
                "Isabella, MI",
                "Lenawee, MI",
                "Mecosta, MI",
                "Oceana, MI",
                "Presque Isle, MI",
                "Roscommon, MI",
                "Tuscola, MI",
                "Wayne, MI",
                "Douglas, NE",
                "Dona Ana, NM",
                "Bronx, NY",
                "Kings, NY",
                "New York, NY",
                "Queens, NY",
                "Richmond, NY",
                "Butler, OH",
                "Carroll, OH",
                "Clark, OH",
                "Cuyahoga, OH",
                "Fayette, OH",
                "Franklin, OH",
                "Greene, OH",
                "Hardin, OH",
                "Harrison, OH",
                "Jefferson, OH",
                "Madison, OH",
                "Morgan, OH",
                "Ottawa, OH",
                "Pike, OH",
                "Ross, OH",
                "Sandusky, OH",
                "Stark, OH",
                "Tuscarawas, OH",
                "Washington, OH",
                "Indiana, PA",
                "Lawrence, PA",
                "Anderson, TX",
                "Bee, TX",
                "Bell, TX",
                "Bexar, TX",
                "Blanco, TX",
                "Brazos, TX",
                "Brewster, TX",
                "Burleson, TX",
                "Cameron, TX",
                "Cochran, TX",
                "Coleman, TX",
                "Collin, TX",
                "Dallas, TX",
                "Denton, TX",
                "Freestone, TX",
                "Gillespie, TX",
                "Goliad, TX",
                "Grayson, TX",
                "Grimes, TX",
                "Hidalgo, TX",
                "Hockley, TX",
                "Jefferson, TX",
                "Jim Wells, TX",
                "Johnson, TX",
                "Kendall, TX",
                "Leon, TX",
                "Live Oak, TX",
                "Llano, TX",
                "Matagorda, TX",
                "Medina, TX",
                "Midland, TX",
                "Milam, TX",
                "Montgomery, TX",
                "Nacogdoches, TX",
                "Nueces, TX",
                "Red River, TX",
                "Reeves, TX",
                "Refugio, TX",
                "Rusk, TX",
                "San Patricio, TX",
                "Smith, TX",
                "Starr, TX",
                "Tarrant, TX",
                "Walker, TX",
                "Wilson, TX",
                "Zapata, TX",
                "San Juan, UT"
              ]
            }
          },
          "states": {
            "title": "States",
            "type": "array",
            "description": "Shorthand for every covered county in a state. Combined with 'Counties'.",
            "items": {
              "type": "string",
              "enum": [
                "AR",
                "CO",
                "CT",
                "IL",
                "MI",
                "NE",
                "NM",
                "NY",
                "OH",
                "PA",
                "TX",
                "UT"
              ]
            }
          },
          "counties": {
            "title": "Counties (free text, for API callers)",
            "type": "array",
            "description": "County names as text, e.g. 'Dallas, TX', 'Cuyahoga County, Ohio', 'Brooklyn' or 'NYC' (all five boroughs). Combined with the dropdown. A county that is not covered returns the free list of the ones that are.",
            "items": {
              "type": "string"
            }
          },
          "county": {
            "title": "County (single)",
            "type": "string",
            "description": "One county; kept for saved tasks and API callers that send one value. Combined with 'Counties'."
          },
          "recordedWithinDays": {
            "title": "Recorded within the last (days)",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Deeds recorded in this many days up to 'Recorded on or before'. Without that date each county's window ends at today minus how far that county's index runs behind (about 7 days for most, 18 for New York City, 60 for Cook County), so every county has rows in a default run.",
            "default": 30
          },
          "recordedAfter": {
            "title": "Recorded on or after (optional)",
            "type": "string",
            "description": "Start date, YYYY-MM-DD. Overrides 'Recorded within the last'."
          },
          "recordedBefore": {
            "title": "Recorded on or before (optional)",
            "type": "string",
            "description": "End date, YYYY-MM-DD. Default: today minus each county's typical posting lag."
          },
          "deedTypesOnly": {
            "title": "Deeds only",
            "type": "boolean",
            "description": "On (default): only deeds that transfer ownership (warranty, special warranty, grant, trustee's, sheriff's and executor's deeds). Off: every land-record document the county indexed in the window (deeds of trust, releases, liens...), each with its own type.",
            "default": true
          },
          "includeNonSaleDeeds": {
            "title": "Include quitclaim, gift and other non-sale deeds",
            "type": "boolean",
            "description": "Also return quitclaim deeds, gift deeds and deeds that rarely mean a sale (corrections, transfer-on-death, life estate, partition).",
            "default": false
          },
          "deedTypes": {
            "title": "Deed types (optional)",
            "type": "array",
            "description": "Keep only these deed types. Empty = every sale deed (warranty, special warranty, grant, plain, trustee's, sheriff's, fiduciary). For a foreclosure list pick trustee_deed and sheriff_deed (sheriff_deed also covers referee, tax and commissioner deeds). Non-sale types (quitclaim, gift, other) can be picked here too. Ignored when 'Deeds only' is off.",
            "items": {
              "type": "string",
              "enum": [
                "warranty_deed",
                "special_warranty_deed",
                "grant_deed",
                "deed",
                "trustee_deed",
                "sheriff_deed",
                "fiduciary_deed",
                "quitclaim_deed",
                "gift_deed",
                "other_deed"
              ]
            }
          },
          "minPrice": {
            "title": "Minimum price ($)",
            "minimum": 0,
            "type": "integer",
            "description": "Only deeds with a recorded price at or above this. Counties whose index has no price (Texas and most other states do not disclose sale prices) return nothing when a price filter is set, and Ohio counties carry a price on only a few deeds (Franklin: 1 of 20), so a price filter drops most of them; a free row says how many were left out."
          },
          "maxPrice": {
            "title": "Maximum price ($)",
            "minimum": 0,
            "type": "integer",
            "description": "Only deeds with a recorded price at or below this."
          },
          "buyerKeywords": {
            "title": "Buyer name contains",
            "type": "array",
            "description": "Keep only deeds where a buyer (grantee) name contains one of these words, e.g. LLC, TRUST, HOMES.",
            "items": {
              "type": "string"
            }
          },
          "excludeBuyerKeywords": {
            "title": "Buyer name does not contain",
            "type": "array",
            "description": "Drop deeds where a buyer (grantee) name contains one of these words, e.g. BANK, CITY OF.",
            "items": {
              "type": "string"
            }
          },
          "includeContacts": {
            "title": "Include buyer contacts",
            "type": "boolean",
            "description": "For deeds whose buyer is a company or trust (never a person), look the buyer up by name in the deed's county and state and add a phone (and website) when a confident match is found. Charged as a separate 'Contact details found' event only on a deed that gets a phone.",
            "default": false
          },
          "maxResults": {
            "title": "Maximum deeds (whole run)",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Spend cap for the WHOLE run, across every county, not per county. The run stops once it has delivered this many deeds. Dallas County alone recorded about 1,200 sale deeds in the week of 3-9 November 2026.",
            "default": 1000
          },
          "listCoverage": {
            "title": "Only list the covered counties",
            "type": "boolean",
            "description": "Return the free list of covered counties (state, whether the index carries a price, how many days behind it usually runs) and search nothing.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional. Most county search sites (all the Texas, Ohio, Michigan and Colorado ones) refuse datacenter IPs, so the actor sends those searches through Apify's residential proxy by default; this setting is used for them only if you pick a proxy group yourself. New York City, Cook County and Douglas County NE use this setting directly (direct is fine).",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}