{
"openapi": "3.0.1",
"info": {
"title": "Utility Rebate Change Tracker",
"description": "Tracks changes in US utility & state energy incentive programs: rebate amount increases/decreases, new and removed programs, eligible equipment changes and date changes. Data source: DSIRE.",
"version": "0.1",
"x-build-id": "fXJFyfFfjcMCXobud"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/springstea~utility-rebate-change-tracker/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-springstea-utility-rebate-change-tracker",
"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/springstea~utility-rebate-change-tracker/runs": {
"post": {
"operationId": "runs-sync-springstea-utility-rebate-change-tracker",
"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/springstea~utility-rebate-change-tracker/run-sync": {
"post": {
"operationId": "run-sync-springstea-utility-rebate-change-tracker",
"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": [
"regions",
"categories"
],
"properties": {
"regions": {
"title": "Regions (US states)",
"type": "array",
"description": "US states to track. Accepts full state names (\"Texas\") or 2-letter codes (\"TX\"). Federal programs that apply everywhere are included by default (see Include federal programs).",
"items": {
"type": "string"
}
},
"categories": {
"title": "Equipment / technology categories",
"type": "array",
"description": "Which incentive categories to track. Supported slugs: hvac, heat-pump, solar, battery (aka storage), ev, ev-charging, water-heater, appliances, lighting, insulation, building-envelope, wind, geothermal, biomass, hydro, fuel-cells, whole-building, energy-efficiency (broad), renewables (broad). You can also pass a raw DSIRE technology id (e.g. 207) or an exact DSIRE technology name (e.g. Solar Photovoltaics).",
"items": {
"type": "string"
}
},
"sectors": {
"title": "Sectors",
"type": "array",
"description": "Optional. Limit to specific sectors, e.g. Residential, Commercial, Industrial, Agricultural. Leave empty to track all sectors.",
"default": [],
"items": {
"type": "string"
}
},
"includeFederal": {
"title": "Include federal programs",
"type": "boolean",
"description": "Federal programs (e.g. the federal tax credits) apply to every state, so DSIRE returns them for each state query. Turn off to track state/utility level programs only.",
"default": true
},
"emitBaselineRecords": {
"title": "Emit baseline records on first run",
"type": "boolean",
"description": "On the very first run there is nothing to compare against. When enabled, every matched program is pushed to the dataset with changeType baseline so you immediately get the full current picture. When disabled, the first run only stores the snapshot and outputs nothing.",
"default": true
},
"snapshotStoreName": {
"title": "Snapshot store name",
"type": "string",
"description": "Name of the (named, persistent) key-value store where snapshots are kept between runs. Change it if you want independent tracking timelines.",
"default": "utility-rebate-tracker"
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "Number of parallel requests against the DSIRE API. Keep it low to be polite.",
"default": 4
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional proxies for the DSIRE requests."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}