{ "openapi": "3.0.1", "info": { "title": "Eviction Dockets Scraper: Harris County Court Records", "description": "Scrape Harris County justice court eviction filings, hearing settings and judgments with party names, rental addresses and claim amounts.", "version": "0.1", "x-build-id": "zIR2NcksOgGhDjePg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~metro-eviction-dockets-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-metro-eviction-dockets-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/parseforge~metro-eviction-dockets-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-metro-eviction-dockets-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/parseforge~metro-eviction-dockets-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-metro-eviction-dockets-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", "properties": { "extracts": { "title": "Docket to scrape", "type": "array", "description": "Cases filed returns new lawsuits, hearings set returns the docket calendar for the days ahead, judgments entered returns cases where the court ruled.", "items": { "type": "string", "enum": [ "casesFiled", "hearingsSet", "judgmentsEntered" ], "enumTitles": [ "Cases filed", "Hearings set", "Judgments entered" ] }, "default": [ "casesFiled" ] }, "caseTypes": { "title": "Case types", "type": "array", "description": "Justice court case types. Eviction is the default. Every value is a code the court's own search page accepts.", "items": { "type": "string", "enum": [ "8464", "8463", "8466", "8465", "51414", "56084", "56085", "58183", "51413", "64033", "56068", "8462", "64007", "56072", "56073", "56074", "56075", "56076", "56079", "56080", "56081", "56083" ], "enumTitles": [ "Eviction", "Debt Claim", "Small Claims", "Repair and Remedy", "Writ of Garnishment", "Writ of Re-Entry", "Writ of Restoration Utility", "Writ of Property Retrieval", "Tow Hearing", "Action of Debt", "Bill of Review", "Bond Forfeiture", "Confirmation of Arbitration Award", "Cruelly Treated Animal", "Dangerous Dog", "Dog Causing Death or Serious Bodily Injury", "Driver's License Suspension Hearing", "Foreign Judgement", "Handgun License", "Occupational Driver's License", "Stolen or Seized Property", "Tax Suit" ] }, "default": [ "8464" ] }, "courts": { "title": "Courts", "type": "array", "description": "All Courts covers the sixteen justice court benches at once. Pick single benches to split the load or to watch one precinct.", "items": { "type": "string", "enum": [ "300", "305", "310", "315", "320", "325", "330", "335", "340", "345", "350", "355", "360", "365", "370", "375", "380" ], "enumTitles": [ "All Courts", "Precinct 1, Place 1", "Precinct 1, Place 2", "Precinct 2, Place 1", "Precinct 2, Place 2", "Precinct 3, Place 1", "Precinct 3, Place 2", "Precinct 4, Place 1", "Precinct 4, Place 2", "Precinct 5, Place 1", "Precinct 5, Place 2", "Precinct 6, Place 1", "Precinct 6, Place 2", "Precinct 7, Place 1", "Precinct 7, Place 2", "Precinct 8, Place 1", "Precinct 8, Place 2" ] }, "default": [ "300" ] }, "dateFrom": { "title": "Date from", "type": "string", "description": "First date, as YYYY-MM-DD. Filings and judgments default to the last seven days; hearings default to today. The court refuses windows over 90 days for filings and judgments and over 31 days for hearings, so wider ranges are split into several requests." }, "dateTo": { "title": "Date to", "type": "string", "description": "Last date, as YYYY-MM-DD. Filings and judgments cannot go past today; hearings cannot go past 31 days from today." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: limited to 10 items (preview). Paid users: up to 1,000,000." }, "cityContains": { "title": "Defendant city contains", "type": "string", "description": "Case-insensitive substring on the defendant city, for example 'Houston' or 'Katy'." }, "zipCodes": { "title": "Defendant ZIP codes", "type": "array", "description": "Keep only cases where the defendant address ZIP matches one of these five-digit codes.", "items": { "type": "string" } }, "caseStatus": { "title": "Case status", "type": "array", "description": "Court status of the case. Active means still open, Disposed means the court has ruled or the case closed.", "items": { "type": "string", "enum": [ "Active", "Disposed", "Inactive", "Appealed" ], "enumTitles": [ "Active", "Disposed", "Inactive", "Appealed" ] } }, "minClaimAmount": { "title": "Minimum claim amount", "minimum": 0, "type": "number", "description": "Keep only cases claiming at least this much, in dollars. Decimals are honoured." }, "maxClaimAmount": { "title": "Maximum claim amount", "minimum": 0, "type": "number", "description": "Keep only cases claiming at most this much, in dollars." }, "plaintiffContains": { "title": "Plaintiff name contains", "type": "string", "description": "Case-insensitive substring on the plaintiff, for example a landlord or management company name." }, "defendantContains": { "title": "Defendant name contains", "type": "string", "description": "Case-insensitive substring on the defendant name." }, "causeOfActionContains": { "title": "Cause of action contains", "type": "string", "description": "Case-insensitive substring on the cause of action, for example 'Nonpayment' or 'Holdover'." }, "onlyWithHearing": { "title": "Only cases with a hearing set", "type": "boolean", "description": "Drop cases that have no next hearing date on the record.", "default": false }, "includeAttorneys": { "title": "Include attorneys", "type": "boolean", "description": "Adds the plaintiff and defendant attorney name and address, twelve columns.", "default": false }, "includeSecondParties": { "title": "Include second plaintiff and defendant", "type": "boolean", "description": "Adds the second plaintiff, second defendant and their attorneys, twenty columns. Multi-tenant filings use these.", "default": false }, "includeJudgmentDetail": { "title": "Include judgment detail", "type": "boolean", "description": "Adds judgment text, date, in favour of, against, amount, attorney fees, court costs and both interest rates.", "default": false }, "includeAddressParse": { "title": "Include parsed property address", "type": "boolean", "description": "Splits the unit number out of the rental address, adds a five-digit ZIP, flags corporate plaintiffs and builds a property key that dedupes one address across cases.", "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 } } }, "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 } } } } } } } } } }