# Recorded Deeds & Property Transfers Scraper (TX, OH, MI, NYC) (`scrapebench/county-recorded-deeds-by-date`) Actor

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.

- **URL**: https://apify.com/scrapebench/county-recorded-deeds-by-date.md
- **Developed by:** [ScrapeBench](https://apify.com/scrapebench) (community)
- **Categories:** Real estate, Lead generation
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.003 / deed record

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Recorded Deeds & Property Transfers Scraper (TX, OH, MI, NYC)

### Pain points

- Every county clerk runs its own land-records search, so following new deeds across a metro means one search per county, per day, per document type.
- The county searches answer one name or one document at a time and page 50 results a screen, with no export of everything recorded this week.
- A week's index mixes deeds with deeds of trust, releases, liens and assumed names; picking out the real transfers is manual work.

### What we solve

- Searches every county you pick (or a whole state) for a date range in one run and returns one row per recorded deed.
- Keeps only deeds that transfer ownership by default, each tagged with one deed type (warranty, special warranty, trustee's, sheriff's...) whatever the county calls it; pick the types yourself for a foreclosure list.
- Filters by buyer name (LLC, TRUST...), by price where the county records one, and flags company and trust buyers.
- Optionally adds a phone (and website) for company and trust buyers, so this week's new LLC and investor buyers become a call list.

### Summary

Pick counties (or a state) and a recording window and get every deed the county recorded: county, document number, deed type in the county's own words and normalized, the recording date, the grantors and grantees the county's index shows, the legal description (with subdivision, lot and block split out where the index does) and, where the index has them, the price (New York City, Cook County and Douglas County NE; only on some Ohio and Michigan deeds), parcel numbers, the return address (Ohio and Michigan only), the parties with their roles, references to earlier documents, and, for New York City only, the property address and the buyer's mailing address. Gaps by county: the signing (instrument) date is missing in Ohio, Colorado, Arkansas, New Mexico, Utah, Cook County and some Michigan counties; the legal description is missing in Cuyahoga, Garland AR, Sterling CT and Cook County. Covers 92 counties (checked 17 November 2026): 85 whose clerks publish a public land-records search (46 in Texas, among them Dallas, Tarrant, Bexar, Collin, Denton, Montgomery and Hidalgo; 19 in Ohio, among them Cuyahoga, Franklin and Stark; 10 in Michigan, among them Wayne (Detroit); Arapahoe, Boulder, Pitkin and Routt in Colorado; 2 in Pennsylvania; Garland AR, Dona Ana NM, San Juan UT and Sterling CT), the five boroughs of New York City, Cook County IL and Douglas County NE (Omaha). You pay per deed delivered.

### Who it's for

- Real-estate investors and wholesalers tracking who is buying, and which LLCs are buying, county by county
- Title, mortgage and insurance marketers reaching new owners right after a deed is recorded
- Home-service businesses (roofing, HVAC, solar, security) building new-homeowner lists
- Analysts and journalists following property transfers, sheriff's and trustee's sales

### How to use

Set the input, run the actor, and collect results from the run's dataset (export to JSON/CSV/Excel, or pull via the Apify API). Example input:

```json
{
  "countyList": [
    "Dallas, TX",
    "Collin, TX"
  ],
  "recordedAfter": "2026-11-03",
  "recordedBefore": "2026-11-09"
}
```

See **Inputs** below for every available field.

### What you get

One row per record:

| Field | Description |
|---|---|
| `county, state` | Where the deed was recorded |
| `document_number, book_page` | The county's instrument number (and book/page where used) |
| `doc_type, deed_type, is_sale_deed` | The county's own document type, one normalized deed type, and whether that type usually means a sale |
| `recorded_date, instrument_date` | When the county recorded it, and when it was signed where the index has that (not in Ohio, Colorado, Arkansas, New Mexico, Utah, Cook or some Michigan counties) |
| `grantors, grantees` | The sellers and buyers the county's index shows (Douglas County NE shows at most two per side; a long list can be cut by the index) |
| `is_entity_buyer` | True when a buyer is an LLC, corporation, trust, bank or government body |
| `consideration` | The price, where the county's index records one: New York City, Cook, Douglas NE, most Michigan deeds (Calhoun: 58 of 60 sampled) and a few Ohio deeds (Franklin: 1 of 20); null elsewhere |
| `legal_description, subdivision, lot, block, legals, parcel_ids` | The legal text, subdivision, lot and block split out where the index structures them (Texas, Michigan, New York City), the full structured legals, and the parcel numbers where the index gives them. No legal text in Cuyahoga, Garland AR, Sterling CT or Cook |
| `parties, marginal_references, referenced_documents, remarks` | The parties the index shows, each with its role (a deed page lists only ten names at a time, so a longer index list is kept as it is), earlier documents it refers to, New York City cross-references and remarks |
| `return_address, recorded_time, book, volume, page, document_id, extras` | Who the deed is returned to (Ohio and Michigan), the time and book/volume/page where the index shows them, and every other column the county publishes |
| `property_address, buyer_mailing_address` | New York City: the property's address and where the buyer gets mail |
| `phone, website` | With 'Include buyer contacts' on: the company or trust buyer's phone and website where a confident match is found; empty otherwise |
| `percent_transferred` | New York City: the share of the property the deed conveys, in percent |
| `document_url` | The deed's page on the county's search; for New York City its ACRIS document page |

Sample:

```json
{
  "county": "Kings",
  "state": "NY",
  "document_number": "2026000282968",
  "doc_type": "DEED",
  "deed_type": "deed",
  "is_sale_deed": true,
  "recorded_date": "2026-10-05",
  "instrument_date": "2026-09-17",
  "grantors": [
    "KE, LIANG YONG"
  ],
  "grantees": [
    "CHEN, YU QING"
  ],
  "consideration": 850000.0,
  "is_entity_buyer": false,
  "legal_description": "Block 5540 Lot 69",
  "subdivision": null,
  "lot": "69",
  "block": "5540",
  "parcel_ids": [
    "3-5540-69"
  ],
  "property_address": "1823 64 STREET, BROOKLYN, NY",
  "buyer_mailing_address": "1823 64TH STREET, BROOKLYN NY 11204",
  "phone": null,
  "website": null,
  "percent_transferred": "100",
  "document_url": "https://a836-acris.nyc.gov/DS/DocumentSearch/DocumentDetail?doc_id=2026091700157001",
  "document_id": "2026091700157001",
  "parties": [
    {
      "name": "KE, LIANG YONG",
      "role": "grantor",
      "address": "1823 64TH STREET, BROOKYLN NY 11204",
      "country": "US"
    },
    {
      "name": "CHEN, YU QING",
      "role": "grantee",
      "address": "1823 64TH STREET, BROOKLYN NY 11204",
      "country": "US"
    }
  ]
}
```

### Inputs

| Field | Required | Type | Default | Description |
|---|---|---|---|---|
| `countyList` | no | array | `["Dallas, TX", "Collin, TX"]` | 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). |
| `states` | no | array | — | Shorthand for every covered county in a state. Combined with 'Counties'. |
| `counties` | no | array | — | 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. |
| `county` | no | string | — | One county; kept for saved tasks and API callers that send one value. Combined with 'Counties'. |
| `recordedWithinDays` | no | integer | `7` | 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. |
| `recordedAfter` | no | string | — | Start date, YYYY-MM-DD. Overrides 'Recorded within the last'. |
| `recordedBefore` | no | string | — | End date, YYYY-MM-DD. Default: today minus each county's typical posting lag. |
| `deedTypesOnly` | no | boolean | `true` | 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. |
| `includeNonSaleDeeds` | no | boolean | `false` | Also return quitclaim deeds, gift deeds and deeds that rarely mean a sale (corrections, transfer-on-death, life estate, partition). |
| `deedTypes` | no | array | — | 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. |
| `minPrice` | no | integer | — | 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` | no | integer | — | Only deeds with a recorded price at or below this. |
| `buyerKeywords` | no | array | — | Keep only deeds where a buyer (grantee) name contains one of these words, e.g. LLC, TRUST, HOMES. |
| `excludeBuyerKeywords` | no | array | — | Drop deeds where a buyer (grantee) name contains one of these words, e.g. BANK, CITY OF. |
| `includeContacts` | no | boolean | `false` | 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. |
| `maxResults` | no | integer | `200` | 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. |
| `listCoverage` | no | boolean | `false` | Return the free list of covered counties (state, whether the index carries a price, how many days behind it usually runs) and search nothing. |
| `proxyConfiguration` | no | object | `{"useApifyProxy": false}` | 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). |

### Pricing (Pay Per Event)

You pay per result (`deed-record`) — **no charge for empty runs**. Example: **1229 deeds** at *$0.003/result* ≈ **$3.69**.

Example: every sale deed Dallas County recorded in the week of 3-9 November 2026 (1,229) costs about $3.69. With 'Include buyer contacts' on, a deed whose company or trust buyer gets a phone also costs $0.002.

### Counties covered

| State | Counties | Sale price in the index | Typical lag |
|---|---|---|---|
| Arkansas | 1 | No | 7 days |
| Colorado | 4 | No | 7 days |
| Connecticut | 1 | No | 7 days |
| Illinois | 1 | Yes | 60 days |
| Michigan | 10 | Yes | 7-21 days |
| Nebraska | 1 | Yes | 8 days |
| New Mexico | 1 | No | 7 days |
| New York | 5 | Yes | 18 days |
| Ohio | 19 | Yes | 7 days |
| Pennsylvania | 2 | No | 7 days |
| Texas | 46 | No | 7 days |
| Utah | 1 | No | 7 days |

New York is the five boroughs of New York City; Illinois is Cook County; Nebraska is Douglas County (Omaha). 'Yes' means the index carries a price (Ohio on only a few deeds). Lag is how far behind the recording date each county's index ran in November 2026. Run with 'Only list the covered counties' for every county, free.

### Use cases

- Weekly new-owner list: every warranty deed recorded last week in your counties, with the buyers' names and the legal description.
- New investor buyers this week, with phone where found: deeds to LLCs and trusts (buyerKeywords: LLC, TRUST; Include buyer contacts on) across Dallas-Fort Worth, Houston's Montgomery County or Greater Cleveland.
- Foreclosure follow-up: set 'Deed types' to trustee_deed and sheriff_deed to get the trustee's and sheriff's deeds (sheriff_deed also covers referee, tax and commissioner deeds) recorded in your counties.
- NYC buyer mailers: deeds recorded in Brooklyn and Queens with the property address and the buyer's mailing address.
- Price-range feed: Cook County or Omaha deeds over $500,000 recorded in a window.

### Why this actor

- Many counties in one run, by recording date, not one name search at a time.
- Deeds only by default, with one normalized deed type across counties that each word it differently.
- The grantors and grantees the county's index shows, with a company-or-trust buyer flag and, on request, that buyer's phone.
- Honest gaps: the price is null where the county does not record one, and a free row explains any county that returned nothing or did not answer.

### Limitations & updates

Covers only the counties listed; other counties are not searched. No price in the Texas, Colorado, Pennsylvania, Arkansas, New Mexico, Utah and Connecticut counties (non-disclosure or not in the index); New York City, Cook County, Douglas County NE and the Ohio and Michigan counties carry it, though an Ohio or Michigan deed recorded without a price shows none. Douglas County NE has no public deed link, only its document id. A name shared by two covered counties (Jefferson TX and OH) searches both unless you add the state. Property and mailing addresses only for New York City. Grantor and grantee lists are what the county's index shows: Douglas County NE lists at most two names per side, and a deed page lists only ten names at a time, so a party list the index cuts is not completed (the row's extras count the names not shown). Douglas County NE's daily search caps at 1,000 documents. The signing (instrument) date is missing in Ohio, Colorado, Arkansas, New Mexico, Utah, Cook County and some Michigan counties; legal text is missing in Cuyahoga, Garland AR, Sterling CT and Cook County. Prices are sparse in Ohio (Franklin: 1 of 20 sampled), so a minimum price drops most Ohio deeds. Cook County rows come from the assessor's sales file, which runs about two months behind. Each county's index is posted after the recording, so the newest days of a window are often still empty. The run searches one county at a time and paces its requests, so a large state takes a few minutes.

### FAQ

**Where does the data come from?**

From each county's own public land-records index (the clerk's or recorder's online search), and for New York City and Cook County from the city's and county's open-data feeds of recorded documents and sales.

**How recent are the deeds?**

As recent as each county posts them. In November 2026 the county clerks' indexes and Douglas County NE ran about a week behind the recording date (Wayne MI about three weeks), New York City about 18 days, and Cook County about two months. Without a 'Recorded on or before' date, each county's window ends at today minus its own lag, so New York City and Cook return rows on default settings. A county with nothing in your window returns a free row that says so.

**Why is the price empty for Texas?**

Texas does not disclose sale prices, and the clerks' search indexes in most other states here do not carry the price either. The price (consideration) is filled for New York City, Cook County and Douglas County NE, and where the clerk recorded one in Ohio and Michigan. Michigan carries it on most deeds (Calhoun: 58 of 60 sampled on 20 November 2026); Ohio only on a few (Franklin: 1 of 20), so a 'Minimum price' filter on Ohio counties drops most of their deeds, and the run says how many it left out.

**Which counties are covered?**

92 counties on 17 November 2026: 46 in Texas (Dallas, Tarrant, Bexar, Collin, Denton, Montgomery, Hidalgo, Jefferson, Cameron, Bell, Nueces and more), 19 in Ohio (Cuyahoga, Franklin, Stark, Butler, Greene and more), 10 in Michigan (Wayne County, Detroit, runs about three weeks behind), 4 in Colorado (Arapahoe, Boulder, Pitkin, Routt), 2 in Pennsylvania, one each in Arkansas, New Mexico, Utah and Connecticut, the five boroughs of New York City, Cook County IL and Douglas County NE. Run with 'Only list the covered counties' for the full list, free.

**What counts as a deed?**

By default the deeds that usually move a property for money: warranty, special warranty, grant, trustee's, sheriff's, executor's and plain deeds. Quitclaim, gift, correction and transfer-on-death deeds come with 'Include quitclaim, gift and other non-sale deeds'. Turn 'Deeds only' off to get every land-record document in the window. 'Deed types' picks exact types instead (for a foreclosure list: trustee_deed and sheriff_deed).

**How am I charged?**

$0.003 per deed delivered. With 'Include buyer contacts' on, a deed whose company or trust buyer gets a phone also costs $0.002 ('Contact details found'); a lookup that finds no phone is free. Notices and the coverage list are free. 'Maximum deeds' caps the whole run.

**Can I get the buyer's phone number?**

For company and trust buyers, yes: turn on 'Include buyer contacts' and each deed whose buyer is an LLC, corporation or trust is looked up by the buyer's name in the deed's county and state. When a confident match is found the row gets a phone (and the website, free). People are never looked up. Every row carries phone, email and website columns, empty when nothing was found; email stays empty, since the lookup finds phones and websites only.

**Is there a property address?**

For New York City only. Everywhere else the row has the legal description, with subdivision, lot and block split out where the county structures them, and the parcel numbers where the index gives them (Cook, Douglas County NE, Ohio and Michigan).

**Can I run it weekly?**

Yes: schedule it with a 14-day window ('Recorded within the last' = 14) and drop the rows you already have by county plus document_number. The overlap catches deeds a county posts a few days late; the pair is unique within a county.

**Do I get the deed image?**

No. Each row links to the deed's page on the county's search (document_url; for New York City its ACRIS document page), and Douglas County NE has no public link, only its document id. The image itself is not downloaded.

**Does it include liens and lis pendens?**

Not by default: the actor returns deeds. With 'Deeds only' off, the county search sites (Texas, Ohio, Michigan, Colorado and the other clerks' sites) and Douglas County NE return every land-record document in the window, liens and lis pendens included where the county indexes them as documents, each with the county's own document type and no normalized deed_type. New York City and Cook County stay deeds and sales only.

### Which actor to choose

Related property tools in the same suite:

- **US Property Records Export & Owner Lookup** — You want every property in a county with its owner and last sale, not only this week's deeds.
- **Recent Home Sales & New Homeowner Leads Scraper** — You want recent home sales in New England and Virginia towns with the buyer's mailing address.

### Guides & use cases

Written up on **[scrapebench.dev](https://scrapebench.dev)** — the bench that runs and verifies this actor against the live source every night:

- **How-to:** [How to run Recorded Deeds & Property Transfers Scraper (TX, OH, MI, NYC)](https://scrapebench.dev/guides/how-to-county-recorded-deeds-by-date/)
- **Use case:** [Dallas-Fort Worth Deeds Recorded This Week: Who the LLC Buyers Are](https://scrapebench.dev/use-cases/dallas-fort-worth-recorded-deeds/)

More actors, coverage and nightly verification results: **[scrapebench.dev](https://scrapebench.dev)**

### Works with AI assistants (MCP)

Callable as an MCP tool, so Claude, Cursor, VS Code Copilot and other MCP clients can run it directly. Grab the config from the [MCP tab](https://apify.com/scrapebench/county-recorded-deeds-by-date/api/mcp) on this page — Apify hosts the server and keeps that snippet current, and OAuth signs you in on first connect, so no API token goes in your config file.

Then just ask:

> "List the deeds recorded in Collin County, Texas between 3 and 9 November 2026 where the buyer is an LLC."

That returned 103 deeds out of the 722 Collin recorded that week, each with the seller, the buyer and the lot and block (test run, 2026-11-17). Runs started this way bill exactly like any other run.

### Use it from an AI agent (Agent Skill)

The free [`scrapebench-property-records`](https://github.com/scrapebenchhq/apify-actor-skills/tree/main/scrapebench-property-records) skill teaches Claude Code and other agents to find the right scrapebench Actor for the task and run it. Copy the folder into `~/.claude/skills/`, set `APIFY_TOKEN`, and ask in plain words.

### Data & lawful use

This actor collects publicly available information that the county clerks and county recorders of the covered counties, which publish their land-records indexes online; the New York City Department of Finance (ACRIS, the Automated City Register Information System, published as NYC Open Data); and the Cook County Assessor's Office (open data) publishes for public
lookup — licence records, business listings and the contact details professionals list there.
Some of it identifies individuals (sole proprietors, licence holders, agents), so treat any
names, phone numbers and emails in your results as personal data.

When you run this actor, you decide what is collected and what it is used for, so you are the
controller of that data and we act only as your processor (Apify Standard Actor Contract).
You need a lawful basis for your use, must honour opt-out and deletion requests, and must
follow the marketing rules that apply to you (CAN-SPAM, TCPA, GDPR, CCPA and similar).
Don't use the output for unsolicited bulk messaging, for screening covered by the FCRA, or
for anything the source's own terms forbid.

Your results are stored in your own Apify account. We don't keep a copy of your results and
don't sell or share them.

### Disclaimer

This is an independent tool. It is not affiliated with, endorsed by or sponsored by
the county clerks and county recorders of the covered counties, which publish their land-records indexes online; the New York City Department of Finance (ACRIS, the Automated City Register Information System, published as NYC Open Data); and the Cook County Assessor's Office (open data). Names and marks are used only to describe the data source. Records are
provided as published by the source and may be out of date or incomplete. For anything
consequential (hiring, a permit, a legal decision), confirm the record with the issuing
agency. You are responsible for making sure your use complies with applicable law and the
source's terms.

### Need help?

Open an issue on this actor's **Issues** tab and we'll respond there. Bug reports, missing
fields and feature requests are all welcome. Guides and examples: [scrapebench.dev](https://scrapebench.dev).

If you are a person named in this data and want your record removed from our copy, email
apify-help@scrapebench.dev; the source agency remains the official record.

Your run may be used to improve our services. If something looks off, or you want this actor to fit your use better, please share your run data with us: [Apify Console → Settings → Security → Share run data with developers](https://console.apify.com/settings/security). It lets us see exactly what went wrong and keep improving the actor.

If this actor saved you time, a short review on its Store page helps other buyers find it.

# Actor input Schema

## `countyList` (type: `array`):

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).

## `states` (type: `array`):

Shorthand for every covered county in a state. Combined with 'Counties'.

## `counties` (type: `array`):

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.

## `county` (type: `string`):

One county; kept for saved tasks and API callers that send one value. Combined with 'Counties'.

## `recordedWithinDays` (type: `integer`):

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.

## `recordedAfter` (type: `string`):

Start date, YYYY-MM-DD. Overrides 'Recorded within the last'.

## `recordedBefore` (type: `string`):

End date, YYYY-MM-DD. Default: today minus each county's typical posting lag.

## `deedTypesOnly` (type: `boolean`):

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.

## `includeNonSaleDeeds` (type: `boolean`):

Also return quitclaim deeds, gift deeds and deeds that rarely mean a sale (corrections, transfer-on-death, life estate, partition).

## `deedTypes` (type: `array`):

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.

## `minPrice` (type: `integer`):

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` (type: `integer`):

Only deeds with a recorded price at or below this.

## `buyerKeywords` (type: `array`):

Keep only deeds where a buyer (grantee) name contains one of these words, e.g. LLC, TRUST, HOMES.

## `excludeBuyerKeywords` (type: `array`):

Drop deeds where a buyer (grantee) name contains one of these words, e.g. BANK, CITY OF.

## `includeContacts` (type: `boolean`):

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.

## `maxResults` (type: `integer`):

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.

## `listCoverage` (type: `boolean`):

Return the free list of covered counties (state, whether the index carries a price, how many days behind it usually runs) and search nothing.

## `proxyConfiguration` (type: `object`):

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).

## Actor input object example

```json
{
  "countyList": [
    "Dallas, TX",
    "Collin, TX"
  ],
  "recordedWithinDays": 7,
  "deedTypesOnly": true,
  "includeNonSaleDeeds": false,
  "includeContacts": false,
  "maxResults": 200,
  "listCoverage": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One row per recorded deed.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "countyList": [
        "Dallas, TX",
        "Collin, TX"
    ],
    "recordedWithinDays": 7,
    "maxResults": 200
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapebench/county-recorded-deeds-by-date").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "countyList": [
        "Dallas, TX",
        "Collin, TX",
    ],
    "recordedWithinDays": 7,
    "maxResults": 200,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapebench/county-recorded-deeds-by-date").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "countyList": [
    "Dallas, TX",
    "Collin, TX"
  ],
  "recordedWithinDays": 7,
  "maxResults": 200
}' |
apify call scrapebench/county-recorded-deeds-by-date --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapebench/county-recorded-deeds-by-date"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/y0Zq7LwQ2GqE2rubH/builds/5NmPe4cclj5kqAgPa/openapi.json
