# Harris County Court Records Scraper (`maximedupre/harris-county-court-records-scraper`) Actor Scrape Harris County County Clerk probate and civil court records. Search by case number, filing date range, party, attorney, or company name, then export case metadata, parties, attorneys, addresses, and filing events. - **URL**: https://apify.com/maximedupre/harris-county-court-records-scraper.md - **Developed by:** [Maxime Duprรฉ](https://apify.com/maximedupre) (community) - **Categories:** Business, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $10.75 / 1,000 court records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### ๐Ÿ”Ž Harris County court records scraper Harris County Court Records Scraper collects public probate and civil case records from the [Harris County County Clerk web search](https://cclerk.hctx.net/Applications/WebSearch/CourtSearch.aspx?CaseType=Probate). Search by case number, filing date range, party name, attorney name, or company name, then export case metadata, parties, attorneys, addresses, filing events, and source context. Use this Harris County court records scraper when you need a repeatable way to turn County Clerk search results into a clean dataset. It is useful for legal research, title work, probate research, due diligence, local market checks, lead research, and recurring case monitoring through Apify schedules or API workflows. For a small first run, keep the prefilled Probate filing-date search and `Court records to save` set to `25`. The Actor saves one dataset item per court record and charges only for saved court records. ### โœ… What this Actor does - Scrapes Harris County County Clerk Probate and Civil case searches. - Searches by case number, filing date range, party, attorney, or company name. - Lets you filter by court and County Clerk case status. - Saves one dataset row per accepted court record. - Fetches case details by default when the source exposes detail links, including parties, party addresses, attorney contact fields, and filing events. - Adds normalized ISO dates where the source date can be parsed. - Adds source context such as case type, search mode, row number, source page, source URL, and scrape time. - Works with Apify dataset exports, API access, schedules, webhooks, and integrations. The Actor focuses on public Harris County County Clerk probate and civil records. It does not scrape Harris County criminal, family, district, tax, property, sheriff, jail, or document-download systems. It also does not provide legal advice or case outcome predictions. ### ๐Ÿ“ฆ What data you get Each dataset item is one Harris County court case record. Some fields can be empty when the County Clerk source does not show that value for a specific case. - `caseNumber`, `court`, `fileDate`, `fileDateIso`, `status`, `caseType` - `typeDescription`, `subtype`, and `style` - `parties[]` with role, name, address, attorney name, firm, address, phone, and fax when shown - `events[]` with event date, normalized event date, description, and comments - `partiesCount`, `eventsCount`, and `detailStatus` - `sourceCounty`, `sourceState`, `sourceHost`, and `sourceCaseType` - `searchMode`, `searchParameters`, `sourceRowNumber`, `sourcePage`, `sourceUrl`, and `scrapedAt` `detailStatus` is `complete` when requested detail tables were fetched, `partial` when a saved case is missing optional detail sections or a name-search result only exposes the matched role/name, and `not_requested` when **Include case details** is turned off. ### ๐ŸŽฏ Common use cases - Look up a known Harris County probate or civil case number. - Export recent filings for a short filing-date range. - Find cases connected to a party, attorney, or company name, including the matched role/name shown in source results. - Build a probate research list with party addresses and event history. - Prepare title, due diligence, or legal research datasets. - Track new County Clerk filings with scheduled Apify runs. - Send court-record rows to a sheet, CRM, database, webhook, or API client. ### โ–ถ๏ธ How to run it 1. Choose **Case type**: Probate or Civil. 2. Choose **Search type**: case number, filing date range, or party/attorney/company name. 3. Fill the matching target section for that search type. 4. Optional: narrow results by **Court** or **Case status**. 5. Keep **Include case details** on when you need parties, attorney fields, addresses, and filing events. 6. Set **Court records to save** to control cost and runtime. 7. Run the Actor and open the dataset. You can export the dataset as JSON, CSV, Excel, XML, RSS, or HTML. You can also call the Actor through the Apify API, schedule repeat runs, or send results to another tool with webhooks. ### โš™๏ธ Input ```json { "caseType": "Probate", "searchMode": "dateRange", "dateFrom": "2025-01-01", "dateTo": "2025-01-02", "court": "All", "status": "All", "includeDetails": true, "maxItems": 25 } ```` #### ๐Ÿ”Ž Search target Use **Case type** to choose the County Clerk case family. Probate supports courts 1-5. Civil supports courts 1-4. Use **Search type** to choose which target section matters for the run: - **Case number**: enter one Harris County case number, such as `W006218`. - **Filing date range**: enter **Filed from** and **Filed to** as `YYYY-MM-DD`. - **Party, attorney, or company name**: choose Party, Attorney, or Company, then enter a last name or company name. First name is optional for party and attorney searches. #### โš–๏ธ Filters and limits Use **Court** and **Case status** when you already know how to narrow the source search. Leave them as `All` for a broader search. Use **Court records to save** as the hard cap for saved rows across the whole run. The default is `25`, which is enough to inspect the output shape before scaling. #### ๐Ÿ“„ Details Keep **Include case details** on when you need party addresses, attorney contact fields, and filing event history. Turn it off when a faster shallow list is enough. Some name-search results only expose the matched role/name in the source list; those rows are saved with `detailStatus` set to `partial` when full detail tables are not available. ### ๐Ÿงพ Output example ```json { "caseNumber": "W006218", "court": "Probate Court 1", "fileDate": "01/02/2025", "fileDateIso": "2025-01-02", "status": "Open", "caseType": "Probate", "typeDescription": "DE", "subtype": "Muniment of Title", "style": "Estate of Kirstene F. Butler", "parties": [ { "caseNumber": "W006218", "role": "Testator", "name": "Kirstene F. Butler", "address": "7951 Dawnridge Drive, Houston TX 77071" } ], "partiesCount": 1, "events": [ { "caseNumber": "W006218", "eventDate": "01/02/2025", "eventDateIso": "2025-01-02", "description": "Affidavit of Testator" } ], "eventsCount": 1, "detailStatus": "complete", "sourceCounty": "Harris County", "sourceState": "TX", "sourceHost": "cclerk.hctx.net", "sourceCaseType": "Probate", "searchMode": "dateRange", "sourceRowNumber": 1, "sourcePage": 1, "sourceUrl": "https://cclerk.hctx.net/Applications/WebSearch/CourtSearch_R.aspx?ID=...", "searchParameters": { "caseType": "Probate", "searchMode": "dateRange", "dateFrom": "2025-01-01", "dateTo": "2025-01-02", "court": "All", "status": "All" }, "scrapedAt": "2026-06-12T19:13:27.000Z" } ``` ### ๐Ÿ’ณ Pricing This Actor uses pay-per-event pricing. You are charged for each saved court record, plus a small Actor start charge. Current row prices are tiered by Apify plan: | Plan | Price per saved court record | Approx. price per 1,000 | | --- | ---: | ---: | | Free | `$0.01435` | `$14.35` | | Bronze | `$0.01315` | `$13.15` | | Silver | `$0.01200` | `$12.00` | | Gold, Platinum, Diamond | `$0.01075` | `$10.75` | No-match searches and handled input errors do not create court-record rows. ### โš ๏ธ Limits and caveats - The Actor reads public Harris County County Clerk probate and civil search results only. - It does not download PDFs, filings, images, or document attachments. - Some cases may have missing party, attorney, address, or event fields when the source does not show them. - Full details are richer but slower because each saved case may need extra detail requests. - Large date ranges can return many cases. Start small, inspect the dataset, then raise the limit. - Court records can be sensitive. Review the source data before using it for legal, compliance, or high-risk decisions. ### โ“ FAQ #### ๐Ÿ” Do I need Harris County login details? No. The public input form does not ask for Harris County cookies, login credentials, API keys, or private access. #### โš–๏ธ Does this cover criminal, family, or district court? No. This Actor is scoped to Harris County County Clerk probate and civil records only. #### ๐Ÿ“„ Does it download court documents? No. It saves case metadata, parties, attorneys, addresses, and filing events. Document downloads are outside the current output contract. #### ๐Ÿงญ What happens if my search finds no records? The run finishes successfully and saves no court-record rows. Adjust the case type, date range, name, court, or status and run it again. #### ๐Ÿงพ Can I use the data through the API? Yes. The saved dataset is available through Apify exports, API clients, webhooks, schedules, and integrations. ### ๐Ÿ“ Changelog - 0.1: Initial release. ### ๐Ÿ†˜ Support For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~harris-county-court-records-scraper/issues) and I'll fix or implement it in less than 24h ๐Ÿซก ### ๐Ÿ”— Other actors - [Realtor Scraper โ†—](https://apify.com/maximedupre/realtor-scraper) - Scrape Realtor.com sale, rent, sold, and pending property listings. - [ForRent Scraper โ†—](https://apify.com/maximedupre/forrent-scraper) - Export public rental property listings with details, contacts, photos, and source URLs. - [Yellow Pages Scraper โ†—](https://apify.com/maximedupre/yellowpages-scraper) - Build local business lead lists with phones, websites, addresses, and ratings. - [Business Address Scraper โ†—](https://apify.com/maximedupre/business-address-scraper) - Find physical addresses shown on submitted company websites. - [Google Maps Shared List Scraper โ†—](https://apify.com/maximedupre/google-maps-shared-list-scraper) - Export saved places from public Google Maps shared lists. **Made with โค๏ธ by Maxime Duprรฉ** # Actor input Schema ## `caseType` (type: `string`): Choose the County Clerk case family to search. ## `searchMode` (type: `string`): Choose how to find matching court records. ## `caseNumber` (type: `string`): Enter one Harris County case number. Example: W006218. ## `dateFrom` (type: `string`): Start of the filing date range. ## `dateTo` (type: `string`): End of the filing date range. ## `partyType` (type: `string`): Choose which name field the County Clerk search should use. ## `lastName` (type: `string`): Enter a last name, attorney last name, or company name. ## `firstName` (type: `string`): Optional for party and attorney name searches. ## `court` (type: `string`): Choose all courts, a Probate court from 1-5, or a Civil court from 1-4. ## `status` (type: `string`): Choose all statuses or one County Clerk case status. ## `includeDetails` (type: `boolean`): Adds party addresses, attorney contact details, and filing event history. Turn this off for faster shallow case lists. ## `maxItems` (type: `integer`): Maximum case records to save across the whole run. ## Actor input object example ```json { "caseType": "Probate", "searchMode": "dateRange", "caseNumber": "W006218", "dateFrom": "2025-01-01", "dateTo": "2025-01-31", "partyType": "Party", "lastName": "Smith", "firstName": "John", "court": "All", "status": "All", "includeDetails": true, "maxItems": 25 } ``` # Actor output Schema ## `results` (type: `string`): Saved case records with parties, attorneys, addresses, filing events, and source metadata. ## `overview` (type: `string`): Open the dataset overview for a quick scan of saved court records. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "caseNumber": "W006218", "lastName": "Smith", "firstName": "John" }; // Run the Actor and wait for it to finish const run = await client.actor("maximedupre/harris-county-court-records-scraper").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "caseNumber": "W006218", "lastName": "Smith", "firstName": "John", } # Run the Actor and wait for it to finish run = client.actor("maximedupre/harris-county-court-records-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "caseNumber": "W006218", "lastName": "Smith", "firstName": "John" }' | apify call maximedupre/harris-county-court-records-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maximedupre/harris-county-court-records-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Harris County Court Records Scraper", "description": "Scrape Harris County County Clerk probate and civil court records. Search by case number, filing date range, party, attorney, or company name, then export case metadata, parties, attorneys, addresses, and filing events.", "version": "0.1", "x-build-id": "Kn1Wlm81RgbW0Belc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~harris-county-court-records-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-harris-county-court-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/maximedupre~harris-county-court-records-scraper/runs": { "post": { "operationId": "runs-sync-maximedupre-harris-county-court-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/maximedupre~harris-county-court-records-scraper/run-sync": { "post": { "operationId": "run-sync-maximedupre-harris-county-court-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": [ "caseType", "searchMode" ], "properties": { "caseType": { "title": "Case type", "enum": [ "Probate", "Civil" ], "type": "string", "description": "Choose the County Clerk case family to search.", "default": "Probate" }, "searchMode": { "title": "Search type", "enum": [ "caseNumber", "dateRange", "partyName" ], "type": "string", "description": "Choose how to find matching court records.", "default": "dateRange" }, "caseNumber": { "title": "Case number", "type": "string", "description": "Enter one Harris County case number. Example: W006218." }, "dateFrom": { "title": "Filed from", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Start of the filing date range.", "default": "2025-01-01" }, "dateTo": { "title": "Filed to", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "End of the filing date range.", "default": "2025-01-31" }, "partyType": { "title": "Name search type", "enum": [ "Party", "Attorney", "Company" ], "type": "string", "description": "Choose which name field the County Clerk search should use.", "default": "Party" }, "lastName": { "title": "Last name or company name", "type": "string", "description": "Enter a last name, attorney last name, or company name." }, "firstName": { "title": "First name", "type": "string", "description": "Optional for party and attorney name searches." }, "court": { "title": "Court", "enum": [ "All", "1", "2", "3", "4", "5" ], "type": "string", "description": "Choose all courts, a Probate court from 1-5, or a Civil court from 1-4.", "default": "All" }, "status": { "title": "Case status", "enum": [ "All", "Closed", "Dismissed", "Inactive", "Open", "Open Garnishment", "Other", "Re-Opened", "Reopen Garnishment" ], "type": "string", "description": "Choose all statuses or one County Clerk case status.", "default": "All" }, "includeDetails": { "title": "Include case details", "type": "boolean", "description": "Adds party addresses, attorney contact details, and filing event history. Turn this off for faster shallow case lists.", "default": true }, "maxItems": { "title": "Court records to save", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum case records to save across the whole run.", "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 } } } } } } } } } } ```