{ "openapi": "3.0.1", "info": { "title": "US Gas & Diesel Prices: Weekly Retail by Region and Grade", "description": "Official weekly US retail fuel prices as clean rows: national, the refining regions, nine states and ten cities, for every grade of gasoline and for diesel, with the move on the week and the year and the spread against the national average.", "version": "0.1", "x-build-id": "mOEG0FZ7kpMCUmtQF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~us-gas-diesel-prices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-us-gas-diesel-prices", "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/scrapemint~us-gas-diesel-prices/runs": { "post": { "operationId": "runs-sync-scrapemint-us-gas-diesel-prices", "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/scrapemint~us-gas-diesel-prices/run-sync": { "post": { "operationId": "run-sync-scrapemint-us-gas-diesel-prices", "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": { "mode": { "title": "Mode", "enum": [ "prices", "history", "series" ], "type": "string", "description": "prices = the latest published week for every region, with the move on the week and year and the spread against the national average. history = one row per region per week. series = what regions and grades are published.", "default": "prices" }, "product": { "title": "Fuel", "enum": [ "gasoline", "diesel" ], "type": "string", "description": "Petrol (gasoline) or diesel. Diesel has no formulation split.", "default": "gasoline" }, "grade": { "title": "Grade", "type": "string", "description": "Gasoline: regular, midgrade, premium or all. Diesel: no2, low_sulfur, ultra_low_sulfur.", "default": "regular" }, "formulation": { "title": "Formulation", "enum": [ "all", "conventional", "reformulated" ], "type": "string", "description": "Gasoline only. conventional, reformulated, or all for both combined.", "default": "all" }, "regions": { "title": "Regions (optional)", "type": "array", "description": "Filter by name, for example California, Gulf Coast, Chicago. Partial names match. Empty returns every region published.", "default": [], "items": { "type": "string" } }, "areaTypes": { "title": "Area types (optional)", "type": "array", "description": "national, region (the refining districts), state, city. Empty returns all of them.", "default": [], "items": { "type": "string" } }, "weeksBack": { "title": "Weeks of history", "minimum": 1, "maximum": 2000, "type": "integer", "description": "History mode. How many weeks back from the latest published week.", "default": 52 }, "startDate": { "title": "Start date (optional)", "type": "string", "description": "History mode. YYYY-MM-DD. Overrides weeks of history.", "default": "" }, "endDate": { "title": "End date (optional)", "type": "string", "description": "History mode. YYYY-MM-DD.", "default": "" }, "maxRows": { "title": "Max rows per run", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap on rows returned. Controls total cost.", "default": 200 } } }, "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 } } } } } } } } } }