{ "openapi": "3.0.1", "info": { "title": "EIA-860M Operator Pipeline & Retirement Reports", "description": "Find US power operators with planned generator additions and scheduled retirements. Filter by state and technology; export capacity totals and complete source-linked generator evidence.", "version": "0.2", "x-build-id": "jROk6IHVTmKcSjFba" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thescrapelab~eia-power-operator-pipeline-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thescrapelab-eia-power-operator-pipeline-intelligence", "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/thescrapelab~eia-power-operator-pipeline-intelligence/runs": { "post": { "operationId": "runs-sync-thescrapelab-eia-power-operator-pipeline-intelligence", "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/thescrapelab~eia-power-operator-pipeline-intelligence/run-sync": { "post": { "operationId": "run-sync-thescrapelab-eia-power-operator-pipeline-intelligence", "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": { "states": { "title": "Project states", "maxItems": 50, "type": "array", "description": "Choose generator locations, not company headquarters. Clear for all main US states; selecting Puerto Rico includes its worksheets automatically.", "items": { "type": "string", "enumSuggestedValues": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "PR" ], "enumTitles": [ "Alabama (AL)", "Alaska (AK)", "Arizona (AZ)", "Arkansas (AR)", "California (CA)", "Colorado (CO)", "Connecticut (CT)", "Delaware (DE)", "District of Columbia (DC)", "Florida (FL)", "Georgia (GA)", "Hawaii (HI)", "Idaho (ID)", "Illinois (IL)", "Indiana (IN)", "Iowa (IA)", "Kansas (KS)", "Kentucky (KY)", "Louisiana (LA)", "Maine (ME)", "Maryland (MD)", "Massachusetts (MA)", "Michigan (MI)", "Minnesota (MN)", "Mississippi (MS)", "Missouri (MO)", "Montana (MT)", "Nebraska (NE)", "Nevada (NV)", "New Hampshire (NH)", "New Jersey (NJ)", "New Mexico (NM)", "New York (NY)", "North Carolina (NC)", "North Dakota (ND)", "Ohio (OH)", "Oklahoma (OK)", "Oregon (OR)", "Pennsylvania (PA)", "Rhode Island (RI)", "South Carolina (SC)", "South Dakota (SD)", "Tennessee (TN)", "Texas (TX)", "Utah (UT)", "Vermont (VT)", "Virginia (VA)", "Washington (WA)", "West Virginia (WV)", "Wisconsin (WI)", "Wyoming (WY)", "Puerto Rico (PR)" ] }, "default": [] }, "activityFilter": { "title": "Operator activity", "enum": [ "any", "both", "additions", "retirements" ], "type": "string", "description": "Choose which operators qualify. Each report keeps all generator evidence matching your other filters.", "default": "any" }, "technologies": { "title": "Technologies", "maxItems": 20, "type": "array", "description": "Choose or type technology phrases. Clear for any technology; matching ignores letter case.", "items": { "type": "string", "enumSuggestedValues": [ "Solar", "Batteries", "Wind", "Natural Gas", "Coal", "Hydro", "Nuclear", "Geothermal", "Biomass" ], "enumTitles": [ "Solar", "Batteries", "Wind", "Natural gas", "Coal", "Hydro", "Nuclear", "Geothermal", "Biomass" ] }, "default": [] }, "entityQueries": { "title": "Operator names (optional)", "maxItems": 20, "type": "array", "description": "Enter name fragments, such as Entergy. Leave empty to discover operators; any listed name can match.", "items": { "type": "string", "minLength": 1, "maxLength": 120 }, "default": [] }, "maxResults": { "title": "Maximum operator reports", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Save up to this many complete operator reports (1–1,000). One report can include several generators.", "default": 5 }, "horizonMonths": { "title": "Planning window (months)", "minimum": 1, "maximum": 60, "type": "integer", "description": "Include plans through this many months after the data month (1–60). Still-pending earlier schedules remain included and flagged.", "default": 24 }, "minimumCapacityMw": { "title": "Minimum generator size (MW)", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Minimum nameplate capacity for each generator, not the operator total. Leave at 0 for no minimum.", "default": 0 }, "entityIds": { "title": "Exact EIA entity IDs", "maxItems": 50, "type": "array", "description": "Optional exact EIA reporting-entity IDs. Leave empty when searching by states, technologies or names.", "items": { "type": "string", "pattern": "^[1-9][0-9]{0,8}$" }, "default": [] }, "includePuertoRico": { "title": "Include Puerto Rico in an unrestricted search", "type": "boolean", "description": "Add Puerto Rico when searching all states. Selecting PR in Project states already enables it.", "default": false }, "watchlistName": { "title": "Saved comparison name", "pattern": "^(?:[a-z0-9][a-z0-9-]{0,39})?$", "maxLength": 40, "type": "string", "description": "Optional lowercase name using letters, digits and hyphens, for example arizona-solar. The first run saves a baseline." }, "changesOnly": { "title": "Save only new baselines and changed reports", "type": "boolean", "description": "Requires a saved comparison name. Unchanged reports are skipped, so a repeat can correctly return zero results.", "default": false }, "afterEntityId": { "title": "Continue after entity ID", "pattern": "^[1-9][0-9]{0,8}$", "type": "string", "description": "Advanced: copy continuation.afterEntityId from SUMMARY, with both expected source guards below and identical filters. Ordering is numeric entity ID." }, "expectedReportingMonth": { "title": "Expected reporting month", "pattern": "^20[0-9]{2}-(0[1-9]|1[0-2])$", "type": "string", "description": "Optional YYYY-MM source guard. Required for continuation. The run stops if the currently published month differs." }, "expectedSourceSha256": { "title": "Expected workbook digest", "pattern": "^[a-f0-9]{64}$", "type": "string", "description": "Optional lowercase SHA-256 guard. Required for continuation so same-month source revisions cannot silently change the paged dataset." } } }, "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 } } } } } } } } } }