{ "openapi": "3.0.1", "info": { "title": "CourtListener Scraper", "description": "CourtListener Scraper is a Python tool designed to extract legal opinions, court dockets, oral arguments, judge profiles, and case citations from CourtListener. It exports structured legal data into clean CSV or JSON formats for legal research and data analysis.", "version": "0.0", "x-build-id": "Wc434tUdE7HFuha40" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zerobreak~CourtListener-Scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zerobreak-CourtListener-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/zerobreak~CourtListener-Scraper/runs": { "post": { "operationId": "runs-sync-zerobreak-CourtListener-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/zerobreak~CourtListener-Scraper/run-sync": { "post": { "operationId": "run-sync-zerobreak-CourtListener-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": [ "mode" ], "properties": { "mode": { "title": "What to search", "enum": [ "opinions", "dockets", "oral_arguments", "judges", "courts", "details" ], "type": "string", "description": "Which CourtListener record type to collect. Opinions, dockets, oral arguments, and judges use search. Courts lists the court directory. Details fetches one record by id and needs an API token.", "default": "opinions" }, "queries": { "title": "Search queries", "type": "array", "description": "Supports CourtListener query syntax (quotes, AND/OR). One query per line. Used for opinions, dockets, oral arguments, and judges.", "items": { "type": "string" } }, "courts": { "title": "Court IDs", "type": "array", "description": "CourtListener court ids, one per line, such as scotus, ca9, or nysd. They are joined with spaces into the court filter. Use courts mode to look up ids.", "items": { "type": "string" } }, "filedAfter": { "title": "Filed after", "type": "string", "description": "Only include records filed on or after this date, in YYYY-MM-DD form." }, "filedBefore": { "title": "Filed before", "type": "string", "description": "Only include records filed on or before this date, in YYYY-MM-DD form." }, "orderBy": { "title": "Order by", "enum": [ "score desc", "dateFiled desc", "dateFiled asc" ], "type": "string", "description": "Sort order for search. score desc ranks by relevance. dateFiled desc and dateFiled asc sort on the filing date.", "default": "score desc" }, "ids": { "title": "IDs (details mode)", "type": "array", "description": "Details mode ids, one per line. Examples: opinion:10822738, cluster:10356150, docket:69510553.", "items": { "type": "string" } }, "includeRecapDocuments": { "title": "Include RECAP document list (dockets)", "type": "boolean", "description": "On docket rows, keep the RECAP document list. Turn this off to store parties and firms without the filing list.", "default": true }, "maxItems": { "title": "Max results (total)", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Free version cap: 5,000 per run. Search returns 20 results per API page.", "default": 100 }, "apiToken": { "title": "CourtListener API token (optional)", "type": "string", "description": "Free at courtlistener.com. Needed only for details mode. Sent as an Authorization token header. Leave blank for public search." }, "timeoutSecs": { "title": "Run timeout (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "Maximum seconds for the whole run. The actor stops cleanly and keeps rows already saved.", "default": 300 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Seconds to wait for a single CourtListener response before retrying.", "default": 30 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional proxy for CourtListener requests. The default sends traffic directly, with no Apify proxy.", "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 } } } } } } } } } }