{ "openapi": "3.0.1", "info": { "title": "Court Case Scraper — US Court Opinions & Dockets", "description": "Scrape US federal and state court records from CourtListener: case name, court, docket number, date filed, judge, attorneys, citations, citation count, precedential status and opinion snippets. Search by keyword, court, judge or date. Covers over 10 million legal documents. No API key.", "version": "0.1", "x-build-id": "t5ejiM9UZ0hdEuU2I" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hichemdev~courtlistener-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hichemdev-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/hichemdev~courtlistener-scraper/runs": { "post": { "operationId": "runs-sync-hichemdev-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/hichemdev~courtlistener-scraper/run-sync": { "post": { "operationId": "run-sync-hichemdev-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", "properties": { "query": { "title": "Search query", "type": "string", "description": "Full-text search across case law, e.g. \"patent infringement\", \"qualified immunity\", a party name or a citation." }, "searchType": { "title": "Record type", "enum": [ "o", "r", "rd", "oa", "p" ], "type": "string", "description": "Which CourtListener collection to search.", "default": "o" }, "court": { "title": "Court", "type": "string", "description": "Court ID to restrict to, e.g. \"scotus\" (Supreme Court), \"ca9\" (9th Circuit), \"cafc\" (Federal Circuit). Space-separate several." }, "judge": { "title": "Judge", "type": "string", "description": "Judge name to filter by, e.g. \"Gorsuch\"." }, "filedAfter": { "title": "Filed after", "type": "string", "description": "Only opinions filed on or after this date. Format MM/DD/YYYY or YYYY-MM-DD." }, "filedBefore": { "title": "Filed before", "type": "string", "description": "Only opinions filed on or before this date." }, "citedGt": { "title": "Minimum citation count", "minimum": 0, "type": "integer", "description": "Only return opinions cited more than this many times — a useful proxy for landmark cases." }, "orderBy": { "title": "Sort order", "enum": [ "score desc", "dateFiled desc", "dateFiled asc", "citeCount desc" ], "type": "string", "description": "How to sort the results.", "default": "score desc" }, "apiToken": { "title": "CourtListener API token (optional)", "type": "string", "description": "A free token from courtlistener.com raises the rate limit substantially. Recommended for large runs." }, "maxResults": { "title": "Max records", "minimum": 1, "type": "integer", "description": "Maximum number of records to scrape.", "default": 100 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. The CourtListener API is public and works without a 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 } } } } } } } } } }