{ "openapi": "3.0.1", "info": { "title": "Court Records API - Case Law & Federal Docket Search Scraper", "description": "Search US judicial opinions and federal RECAP/PACER dockets through the CourtListener API by keyword, court and filing date. A case law scraper that filters dockets by nature of suit - patent, trademark, antitrust, securities - and exports parties, judge, attorneys and firms. 55 columns per record.", "version": "0.1", "x-build-id": "Y4cdyM4XHOdoVN2tb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/captainhandsome~courtlistener-case-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-captainhandsome-courtlistener-case-search", "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/captainhandsome~courtlistener-case-search/runs": { "post": { "operationId": "runs-sync-captainhandsome-courtlistener-case-search", "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/captainhandsome~courtlistener-case-search/run-sync": { "post": { "operationId": "run-sync-captainhandsome-courtlistener-case-search", "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": { "search_type": { "title": "What to search", "enum": [ "opinions", "dockets" ], "type": "string", "description": "Published judicial opinions, or federal court dockets from RECAP.", "default": "opinions" }, "query": { "title": "Search term", "type": "string", "description": "Free text across case name and full text, e.g. 'patent infringement' or a company name." }, "court": { "title": "Court", "type": "string", "description": "CourtListener court ID, e.g. cafc (Federal Circuit), txed (E.D. Texas), ca9 (Ninth Circuit)." }, "nature_of_suit": { "title": "Nature of suit code", "type": "string", "description": "Federal civil suit code. Business codes: 110 Insurance, 190 Contract, 410 Antitrust, 430 Banks, 470 RICO, 820 Copyright, 830 Patent, 840 Trademark, 850 Securities. Dockets only." }, "filed_after": { "title": "Filed after", "type": "string", "description": "YYYY-MM-DD." }, "filed_before": { "title": "Filed before", "type": "string", "description": "YYYY-MM-DD." }, "max_items": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on results returned. Also caps your spend.", "default": 100 }, "include_court_details": { "title": "Add court jurisdiction and website", "type": "boolean", "description": "Look each court up once to add its jurisdiction level (Federal District, State Supreme, Federal Bankruptcy and so on), homepage and PACER court ID. The lookup is cached, so it costs one extra request per distinct court in the run rather than one per row. Turn it off for the fastest possible run.", "default": true } } }, "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 } } } } } } } } } }