# Gas Prices data surface

Use this as compact context for the bluedoor Gas Prices API data pages.

Primary URLs:

- Data home: https://bluedoor.sh/data/gas-prices
- API landing page: https://bluedoor.sh/apis/gas-prices
- Docs: https://bluedoor.sh/apis/gas-prices/docs
- OpenAPI JSON: https://bluedoor.sh/apis/gas-prices/docs/openapi.json
- API base URL: https://api.bluedoor.sh/gas-prices/v1

Access model:

- Anonymous reads are public and rate limited.
- Email-authenticated API keys use the standard bluedoor token bucket.
- fresh=true requires a verified email API key.
- Sixteen retailer chains are synced daily across 50 states.

Collections:

- Chains: Fuel retailer chains with coverage tier, expected and observed station counts, fuel grades, price availability, and adapter status. Route: /chains
- Stations: Individual gas stations with chain, brand, address, geocode, fuel grades carried, and price freshness, filterable by chain, state, and grade. Route: /stations
- Prices: Flattened fuel price points by grade and price type (posted, cash, credit) with station, brand, location, and observation timestamps. Route: /prices
- States: State-by-state coverage: station counts, price-point counts, and the number of chains observed in each state. Route: /coverage/states
- Search: Cross-entity search over chains and stations by name, brand, city, or chain. Route: /search

Important pages:

- https://bluedoor.sh/data/gas-prices/chains
- https://bluedoor.sh/data/gas-prices/stations
- https://bluedoor.sh/data/gas-prices/prices
- https://bluedoor.sh/data/gas-prices/states
- https://bluedoor.sh/data/gas-prices/search
- https://bluedoor.sh/data/gas-prices/indexes

Crawl seeding:

- Sitemap: https://bluedoor.sh/data/gas-prices/sitemap.xml
- Seeded URLs: 88
- Seed searches: wawa, costco, circle k, 7-eleven, racetrac, diesel