{ "openapi": "3.0.1", "info": { "title": "LegalHarvest — All-in-One U.S. Legal Research", "description": "Search court records, case law, statutes, legislation, corporate filings, and federal regulations across 6+ free legal databases in one actor.", "version": "0.1", "x-build-id": "tqelbwfVpl51algjg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/valor-investigations~legalharvest/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-valor-investigations-legalharvest", "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/valor-investigations~legalharvest/runs": { "post": { "operationId": "runs-sync-valor-investigations-legalharvest", "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/valor-investigations~legalharvest/run-sync": { "post": { "operationId": "run-sync-valor-investigations-legalharvest", "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": [ "query" ], "properties": { "query": { "title": "Search query", "type": "string", "description": "The keyword, citation, company, bill, or docket query to search across enabled sources. Citation examples: ORS 192.431, 42 U.S.C. 1983, 45 CFR 164.512, A.R.S. 39-121, California Penal Code 187, Florida Statutes 119.07, ORC 2903.02, MCL 15.231, RCW 42.56.070, NCGS 132-1, Virginia Code 2.2-3704, HB 4040. Oregon ORS remains the direct official state-statute adapter, and exact Arizona, California, Florida, Michigan, North Carolina, Ohio, Texas, Virginia, and Washington section citations now use official state backends when possible.", "default": "Brown v. Board of Education" }, "search_mode": { "title": "Search mode", "enum": [ "all", "case_law", "legislation", "statutes", "regulations", "dockets", "corporate", "spending" ], "type": "string", "description": "Choose which legal surface to search. In all mode, exact citations are auto-routed to the most relevant official sources when supported. Statute mode covers federal U.S. Code, official Oregon ORS lookups, official Arizona, California, Florida, Michigan, North Carolina, Ohio, Texas, Virginia, and Washington exact section lookups, and search-backed multi-state public statute lookup for other non-Oregon queries.", "default": "all" }, "jurisdictions": { "title": "Jurisdictions", "type": "array", "description": "Optional list of jurisdiction filters. Use state names or abbreviations like or, az, ca, fl, mi, nc, oh, tx, va, wa, or washington for Open States bill queries. Oregon routes to the official ORS adapter; Arizona, California, Florida, Michigan, North Carolina, Ohio, Texas, Virginia, and Washington exact section citations use official state backends when possible; other state statute lookups use the search-backed public state-statute source.", "items": { "type": "string" }, "default": [] }, "sources": { "title": "Sources", "type": "array", "description": "Optional source override. Leave empty to use the default sources for the selected search mode. Supported values: courtlistener, congress_gov, ecfr, govinfo, federal_register, openstates, oregon_ors, sec_edgar, state_statutes, usaspending, us_code.", "items": { "type": "string" }, "default": [] }, "date_from": { "title": "Date from", "type": "string", "description": "Optional start date in YYYY-MM-DD format." }, "date_to": { "title": "Date to", "type": "string", "description": "Optional end date in YYYY-MM-DD format." }, "max_results": { "title": "Max results", "minimum": 1, "maximum": 250, "type": "integer", "description": "Maximum normalized results to keep after aggregation.", "default": 25 }, "include_full_text": { "title": "Include full text", "type": "boolean", "description": "Request full text where a source supports it.", "default": false }, "include_raw": { "title": "Include raw source payloads", "type": "boolean", "description": "Include raw source payloads in normalized results for debugging and schema refinement.", "default": false }, "api_data_gov_key": { "title": "Data.gov API key", "type": "string", "description": "Optional bring-your-own API key for Congress.gov and GovInfo. Leave blank to use the actor owner's configured fallback if available." }, "courtlistener_api_token": { "title": "CourtListener API token", "type": "string", "description": "Optional bring-your-own CourtListener token for authenticated CourtListener requests. Leave blank to use the actor owner's configured fallback if available." }, "openstates_api_key": { "title": "OpenStates API key", "type": "string", "description": "Optional bring-your-own OpenStates key for state bill searches. Leave blank to use the actor owner's configured fallback if available." } } }, "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 } } } } } } } } } }