{
  "data": {
    "id": "WGBnikzS50WwGLCOA",
    "actId": "i0pJ7pbD6yKWoYc8s",
    "userId": "zq8lKbpLzTjGDayPC",
    "startedAt": "2026-11-19T01:41:56.224Z",
    "finishedAt": "2026-11-19T01:42:16.593Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CI"
    },
    "stats": {
      "durationMillis": 20290,
      "runTimeSecs": 20.29,
      "computeUnits": 0.022544444444444443,
      "imageSizeBytes": 371685888
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "GK9YjZRyQZVzOdoH5",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Fuel Prices Scraper Input\",\n  \"description\": \"Daily US fuel prices from the AAA Fuel Gauge (gasprices.aaa.com). National, state, and metro/county granularity.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to scrape. `national` = single record (US average). `state` = 51 records (50 states + DC) with current/yesterday/week/month/year-ago prices. `metro` = metro/county-level prices for the requested states.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"national\",\n        \"state\",\n        \"metro\"\n      ],\n      \"enumTitles\": [\n        \"National average (1 record)\",\n        \"State averages (50 + DC)\",\n        \"Metro/county averages (per-state)\"\n      ],\n      \"default\": \"state\",\n      \"prefill\": \"state\"\n    },\n    \"states\": {\n      \"title\": \"States allowlist\",\n      \"type\": \"array\",\n      \"description\": \"Two-letter state codes (e.g. `NY`, `CA`, `TX`). Empty = all 50 states + DC. For `mode=metro`, this controls which state pages get scraped.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"fuelTypes\": {\n      \"title\": \"Fuel types\",\n      \"type\": \"array\",\n      \"description\": \"Which fuel grades to include in each record. Empty = all four (regular, midGrade, premium, diesel).\",\n      \"editor\": \"select\",\n      \"items\": {\n        \"type\": \"string\",\n        \"enum\": [\n          \"regular\",\n          \"midGrade\",\n          \"premium\",\n          \"diesel\"\n        ],\n        \"enumTitles\": [\n          \"Regular\",\n          \"Mid-grade\",\n          \"Premium\",\n          \"Diesel\"\n        ]\n      },\n      \"default\": [\n        \"regular\",\n        \"midGrade\",\n        \"premium\",\n        \"diesel\"\n      ],\n      \"prefill\": [\n        \"regular\",\n        \"midGrade\",\n        \"premium\",\n        \"diesel\"\n      ]\n    },\n    \"includeHistory\": {\n      \"title\": \"Include price history\",\n      \"type\": \"boolean\",\n      \"description\": \"When true (state/metro modes), include yesterday/week-ago/month-ago/year-ago averages. Default true.\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"minPrice\": {\n      \"title\": \"Min price (USD/gal)\",\n      \"type\": \"number\",\n      \"description\": \"Drop records whose primary fuel (regular by default) is below this price.\",\n      \"minimum\": 0,\n      \"maximum\": 20\n    },\n    \"maxPrice\": {\n      \"title\": \"Max price (USD/gal)\",\n      \"type\": \"number\",\n      \"description\": \"Drop records whose primary fuel (regular by default) is above this price.\",\n      \"minimum\": 0,\n      \"maximum\": 20\n    },\n    \"primaryFuelType\": {\n      \"title\": \"Primary fuel type for filters/sort\",\n      \"type\": \"string\",\n      \"description\": \"Which fuel grade is used by `minPrice` / `maxPrice` / `sortBy` filters. Default: regular.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"regular\",\n        \"midGrade\",\n        \"premium\",\n        \"diesel\"\n      ],\n      \"enumTitles\": [\n        \"Regular\",\n        \"Mid-grade\",\n        \"Premium\",\n        \"Diesel\"\n      ],\n      \"default\": \"regular\",\n      \"prefill\": \"regular\"\n    },\n    \"sortBy\": {\n      \"title\": \"Sort by\",\n      \"type\": \"string\",\n      \"description\": \"How to order emitted records. Cheapest-first / most-expensive-first / alphabetical by state.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"price_asc\",\n        \"price_desc\",\n        \"state_asc\"\n      ],\n      \"enumTitles\": [\n        \"Price ascending (cheapest first)\",\n        \"Price descending (most expensive first)\",\n        \"State alphabetical\"\n      ],\n      \"default\": \"state_asc\",\n      \"prefill\": \"state_asc\"\n    },\n    \"includeChangeMetrics\": {\n      \"title\": \"Include derived change metrics\",\n      \"type\": \"boolean\",\n      \"description\": \"When true and history is fetched, also emit `changeFromYesterday`, `changeFromWeekAgo`, `changeFromMonthAgo`, `changeFromYearAgo` (in cents).\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"metroNameFilter\": {\n      \"title\": \"Metro name filter (mode=metro only)\",\n      \"type\": \"array\",\n      \"description\": \"Only emit metro records whose name contains one of these substrings (case-insensitive). e.g. ['New York','Los Angeles'].\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on emitted records.\",\n      \"minimum\": 1,\n      \"maximum\": 5000,\n      \"default\": 500,\n      \"prefill\": 500\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# US Gas Price Tracker by State & Metro\n\nGet daily US gas and diesel prices without visiting a fuel-price site yourself. This actor reads the public AAA Fuel Gauge data and returns it as structured records at whichever level you need: one national figure, all 50 states plus DC, or metro/county breakdowns within specific states.\n\n## What this actor does\n\n- **Three scopes:** a single national average, state-level averages (50 states + DC), or metro/county averages within chosen states\n- **Four fuel grades:** regular, mid-grade, premium, and diesel, each only included when the source actually publishes it\n- **Historical comparison:** yesterday, week-ago, month-ago, and year-ago prices alongside today's, plus derived cent-value changes for a chosen primary fuel\n- **Narrowing filters:** by state, by fuel grade, by a price band on the primary fuel, and by metro-name substring\n- **Empty fields are omitted** — a record only includes the fuel grades and history buckets the source actually published for it\n\n## Output per record\n\n- `scope` — `national`, `state`, or `metro`\n- `country` — always `US`, present only on national records\n- `state`, `stateCode` — state name and two-letter code, present on state and metro records\n- `metro` — metro/county area name, present only on metro records\n- `regular`, `midGrade`, `premium`, `diesel` — current price in USD/gallon for each grade the source publishes\n- `history` — an object with `yesterday`, `weekAgo`, `monthAgo`, and `yearAgo` prices per fuel grade, when `includeHistory` is enabled (state/metro modes) or whenever the source publishes it on the home page (national mode, where `includeHistory` isn't consulted)\n- `changeFromYesterday`, `changeFromWeekAgo`, `changeFromMonthAgo`, `changeFromYearAgo` — price change in cents for the chosen `primaryFuelType`, when `includeChangeMetrics` is enabled and the matching history value exists\n- `recordType` — always `fuelPrices`\n- `scrapedAt` — when the record was fetched\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `state` | `national` (1 record), `state` (50 + DC), or `metro` (per-state metro/county averages) |\n| `states` | array | `[]` | Two-letter state codes to include (e.g. `NY`, `CA`). Empty includes all 50 states + DC. For `mode=metro`, this also controls which states' metro pages are read |\n| `fuelTypes` | array | `[\"regular\",\"midGrade\",\"premium\",\"diesel\"]` | Which fuel grades to include in each record |\n| `includeHistory` | boolean | `true` | Include yesterday/week-ago/month-ago/year-ago prices (state/metro modes) |\n| `minPrice` | number | – | Drop records whose primary fuel is priced below this value |\n| `maxPrice` | number | – | Drop records whose primary fuel is priced above this value |\n| `primaryFuelType` | string | `regular` | Which fuel grade `minPrice`, `maxPrice`, `sortBy`, and the change metrics use |\n| `sortBy` | string | `state_asc` | `price_asc`, `price_desc`, or `state_asc` |\n| `includeChangeMetrics` | boolean | `true` | Compute `changeFromYesterday`/`changeFromWeekAgo`/`changeFromMonthAgo`/`changeFromYearAgo` in cents, when history is available |\n| `metroNameFilter` | array | `[]` | Only emit metro records whose name contains one of these substrings (mode=metro only) |\n| `maxItems` | integer | `500` | Hard cap on emitted records (1–5000) |\n\n### Example: all states, cheapest first\n\n```json\n{\n  \"mode\": \"state\",\n  \"sortBy\": \"price_asc\",\n  \"includeHistory\": true\n}\n```\n\n### Example: metro breakdown for two states\n\n```json\n{\n  \"mode\": \"metro\",\n  \"states\": [\"NY\", \"CA\"],\n  \"metroNameFilter\": [\"new york\", \"los angeles\", \"san francisco\"]\n}\n```\n\n### Example: cheapest diesel states only\n\n```json\n{\n  \"mode\": \"state\",\n  \"primaryFuelType\": \"diesel\",\n  \"fuelTypes\": [\"diesel\"],\n  \"sortBy\": \"price_asc\",\n  \"maxItems\": 10\n}\n```\n\n## Use cases\n\n- **Fleet and logistics planning** — compare diesel prices across states before routing\n- **News and editorial research** — pull a \"cheapest gas by state\" snapshot on demand\n- **Consumer price widgets** — feed a national or regional average into a dashboard\n- **Trend monitoring** — watch `changeFromYearAgo` to catch large year-over-year price swings\n- **Economic analysis** — fuel prices as an input to broader cost-of-living or inflation tracking\n\n## FAQ\n\n**Where does this data come from?**\nThe public AAA Fuel Gauge pages, the same averages AAA publishes for national, state, and metro-level gas prices.\n\n**Do I need a login, cookies, or proxy?**\nNo. The source pages are fully public and the actor reads them without authentication.\n\n**Does this cover countries outside the US?**\nNo, this is US-only; the underlying source does not publish averages for other countries.\n\n**Why isn't per-station pricing included?**\nThis actor reports state and metro averages rather than individual gas-station prices, since AAA's own data is published at that level.\n\n**How current is the data?**\nAAA refreshes its averages daily, and each run reads the page live, so results reflect whatever AAA has published at run time.\n\n**Why might a record be missing a fuel grade?**\nNot every state or metro area has a published price for every grade (mid-grade and premium especially). The actor omits a grade from a record rather than sending a null or zero value.\n\n**Why is a change metric like `changeFromMonthAgo` sometimes absent?**\nIt's only computed when both the current price and the matching history value are available for that record's primary fuel.\n\n**What does `metroNameFilter` match against?**\nA case-insensitive substring match against the metro/county area name as published by AAA (e.g. `Albany-Schenectady-Troy`, `Nassau-Suffolk`).\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "us-gas-price-tracker-by-state-and-metro",
      "title": "US Gas Price Tracker by State & Metro",
      "description": "Daily US fuel prices for regular, mid-grade, premium, and diesel at the national, state, and metro level, with yesterday/week/month/year-ago history and derived price changes.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# US Gas Price Tracker by State & Metro\n\nGet daily US gas and diesel prices without visiting a fuel-price site yourself. This actor reads the public AAA Fuel Gauge data and returns it as structured records at whichever level you need: one national figure, all 50 states plus DC, or metro/county breakdowns within specific states.\n\n## What this actor does\n\n- **Three scopes:** a single national average, state-level averages (50 states + DC), or metro/county averages within chosen states\n- **Four fuel grades:** regular, mid-grade, premium, and diesel, each only included when the source actually publishes it\n- **Historical comparison:** yesterday, week-ago, month-ago, and year-ago prices alongside today's, plus derived cent-value changes for a chosen primary fuel\n- **Narrowing filters:** by state, by fuel grade, by a price band on the primary fuel, and by metro-name substring\n- **Empty fields are omitted** — a record only includes the fuel grades and history buckets the source actually published for it\n\n## Output per record\n\n- `scope` — `national`, `state`, or `metro`\n- `country` — always `US`, present only on national records\n- `state`, `stateCode` — state name and two-letter code, present on state and metro records\n- `metro` — metro/county area name, present only on metro records\n- `regular`, `midGrade`, `premium`, `diesel` — current price in USD/gallon for each grade the source publishes\n- `history` — an object with `yesterday`, `weekAgo`, `monthAgo`, and `yearAgo` prices per fuel grade, when `includeHistory` is enabled (state/metro modes) or whenever the source publishes it on the home page (national mode, where `includeHistory` isn't consulted)\n- `changeFromYesterday`, `changeFromWeekAgo`, `changeFromMonthAgo`, `changeFromYearAgo` — price change in cents for the chosen `primaryFuelType`, when `includeChangeMetrics` is enabled and the matching history value exists\n- `recordType` — always `fuelPrices`\n- `scrapedAt` — when the record was fetched\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `state` | `national` (1 record), `state` (50 + DC), or `metro` (per-state metro/county averages) |\n| `states` | array | `[]` | Two-letter state codes to include (e.g. `NY`, `CA`). Empty includes all 50 states + DC. For `mode=metro`, this also controls which states' metro pages are read |\n| `fuelTypes` | array | `[\"regular\",\"midGrade\",\"premium\",\"diesel\"]` | Which fuel grades to include in each record |\n| `includeHistory` | boolean | `true` | Include yesterday/week-ago/month-ago/year-ago prices (state/metro modes) |\n| `minPrice` | number | – | Drop records whose primary fuel is priced below this value |\n| `maxPrice` | number | – | Drop records whose primary fuel is priced above this value |\n| `primaryFuelType` | string | `regular` | Which fuel grade `minPrice`, `maxPrice`, `sortBy`, and the change metrics use |\n| `sortBy` | string | `state_asc` | `price_asc`, `price_desc`, or `state_asc` |\n| `includeChangeMetrics` | boolean | `true` | Compute `changeFromYesterday`/`changeFromWeekAgo`/`changeFromMonthAgo`/`changeFromYearAgo` in cents, when history is available |\n| `metroNameFilter` | array | `[]` | Only emit metro records whose name contains one of these substrings (mode=metro only) |\n| `maxItems` | integer | `500` | Hard cap on emitted records (1–5000) |\n\n### Example: all states, cheapest first\n\n```json\n{\n  \"mode\": \"state\",\n  \"sortBy\": \"price_asc\",\n  \"includeHistory\": true\n}\n```\n\n### Example: metro breakdown for two states\n\n```json\n{\n  \"mode\": \"metro\",\n  \"states\": [\"NY\", \"CA\"],\n  \"metroNameFilter\": [\"new york\", \"los angeles\", \"san francisco\"]\n}\n```\n\n### Example: cheapest diesel states only\n\n```json\n{\n  \"mode\": \"state\",\n  \"primaryFuelType\": \"diesel\",\n  \"fuelTypes\": [\"diesel\"],\n  \"sortBy\": \"price_asc\",\n  \"maxItems\": 10\n}\n```\n\n## Use cases\n\n- **Fleet and logistics planning** — compare diesel prices across states before routing\n- **News and editorial research** — pull a \"cheapest gas by state\" snapshot on demand\n- **Consumer price widgets** — feed a national or regional average into a dashboard\n- **Trend monitoring** — watch `changeFromYearAgo` to catch large year-over-year price swings\n- **Economic analysis** — fuel prices as an input to broader cost-of-living or inflation tracking\n\n## FAQ\n\n**Where does this data come from?**\nThe public AAA Fuel Gauge pages, the same averages AAA publishes for national, state, and metro-level gas prices.\n\n**Do I need a login, cookies, or proxy?**\nNo. The source pages are fully public and the actor reads them without authentication.\n\n**Does this cover countries outside the US?**\nNo, this is US-only; the underlying source does not publish averages for other countries.\n\n**Why isn't per-station pricing included?**\nThis actor reports state and metro averages rather than individual gas-station prices, since AAA's own data is published at that level.\n\n**How current is the data?**\nAAA refreshes its averages daily, and each run reads the page live, so results reflect whatever AAA has published at run time.\n\n**Why might a record be missing a fuel grade?**\nNot every state or metro area has a published price for every grade (mid-grade and premium especially). The actor omits a grade from a record rather than sending a null or zero value.\n\n**Why is a change metric like `changeFromMonthAgo` sometimes absent?**\nIt's only computed when both the current price and the matching history value are available for that record's primary fuel.\n\n**What does `metroNameFilter` match against?**\nA case-insensitive substring match against the metro/county area name as published by AAA (e.g. `Albany-Schenectady-Troy`, `Nassau-Suffolk`).\n",
      "input": {
        "title": "Fuel Prices Scraper Input",
        "description": "Daily US fuel prices from the AAA Fuel Gauge (gasprices.aaa.com). National, state, and metro/county granularity.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to scrape. `national` = single record (US average). `state` = 51 records (50 states + DC) with current/yesterday/week/month/year-ago prices. `metro` = metro/county-level prices for the requested states.",
            "editor": "select",
            "enum": [
              "national",
              "state",
              "metro"
            ],
            "enumTitles": [
              "National average (1 record)",
              "State averages (50 + DC)",
              "Metro/county averages (per-state)"
            ],
            "default": "state",
            "prefill": "state"
          },
          "states": {
            "title": "States allowlist",
            "type": "array",
            "description": "Two-letter state codes (e.g. `NY`, `CA`, `TX`). Empty = all 50 states + DC. For `mode=metro`, this controls which state pages get scraped.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "fuelTypes": {
            "title": "Fuel types",
            "type": "array",
            "description": "Which fuel grades to include in each record. Empty = all four (regular, midGrade, premium, diesel).",
            "editor": "select",
            "items": {
              "type": "string",
              "enum": [
                "regular",
                "midGrade",
                "premium",
                "diesel"
              ],
              "enumTitles": [
                "Regular",
                "Mid-grade",
                "Premium",
                "Diesel"
              ]
            },
            "default": [
              "regular",
              "midGrade",
              "premium",
              "diesel"
            ],
            "prefill": [
              "regular",
              "midGrade",
              "premium",
              "diesel"
            ]
          },
          "includeHistory": {
            "title": "Include price history",
            "type": "boolean",
            "description": "When true (state/metro modes), include yesterday/week-ago/month-ago/year-ago averages. Default true.",
            "default": true,
            "prefill": true
          },
          "minPrice": {
            "title": "Min price (USD/gal)",
            "type": "number",
            "description": "Drop records whose primary fuel (regular by default) is below this price.",
            "minimum": 0,
            "maximum": 20
          },
          "maxPrice": {
            "title": "Max price (USD/gal)",
            "type": "number",
            "description": "Drop records whose primary fuel (regular by default) is above this price.",
            "minimum": 0,
            "maximum": 20
          },
          "primaryFuelType": {
            "title": "Primary fuel type for filters/sort",
            "type": "string",
            "description": "Which fuel grade is used by `minPrice` / `maxPrice` / `sortBy` filters. Default: regular.",
            "editor": "select",
            "enum": [
              "regular",
              "midGrade",
              "premium",
              "diesel"
            ],
            "enumTitles": [
              "Regular",
              "Mid-grade",
              "Premium",
              "Diesel"
            ],
            "default": "regular",
            "prefill": "regular"
          },
          "sortBy": {
            "title": "Sort by",
            "type": "string",
            "description": "How to order emitted records. Cheapest-first / most-expensive-first / alphabetical by state.",
            "editor": "select",
            "enum": [
              "price_asc",
              "price_desc",
              "state_asc"
            ],
            "enumTitles": [
              "Price ascending (cheapest first)",
              "Price descending (most expensive first)",
              "State alphabetical"
            ],
            "default": "state_asc",
            "prefill": "state_asc"
          },
          "includeChangeMetrics": {
            "title": "Include derived change metrics",
            "type": "boolean",
            "description": "When true and history is fetched, also emit `changeFromYesterday`, `changeFromWeekAgo`, `changeFromMonthAgo`, `changeFromYearAgo` (in cents).",
            "default": true,
            "prefill": true
          },
          "metroNameFilter": {
            "title": "Metro name filter (mode=metro only)",
            "type": "array",
            "description": "Only emit metro records whose name contains one of these substrings (case-insensitive). e.g. ['New York','Los Angeles'].",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on emitted records.",
            "minimum": 1,
            "maximum": 5000,
            "default": 500,
            "prefill": 500
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "US Gas Price Tracker by State & Metro Output",
        "description": "US fuel price records at the national, state, or metro level with regular/mid-grade/premium/diesel prices, history, and derived price changes.",
        "properties": {
          "fuelPrices": {
            "type": "string",
            "title": "US fuel price records",
            "description": "Dataset containing all scraped US fuel price records.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Fuel Prices",
              "transformation": {
                "fields": [
                  "scope",
                  "state",
                  "metro",
                  "regular",
                  "midGrade",
                  "premium",
                  "diesel",
                  "scrapedAt"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.1",
    "imageDigest": "a13a1df9fcfdf625c68a276b6c358d9c1d68fc45a72176daa25bbf4e9972d961",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.022544444444444443
    }
  }
}