# Gas Québec (Gas Quebec)

> Real-time fuel price tracker for all 17 administrative regions of Quebec, Canada. Prices are sourced from Régie Essence Québec (Régie de l'énergie).

Gas Québec (Gas Quebec in English) tracks gasoline (regular/ordinaire), premium (super/suprême), and diesel prices across Quebec's administrative regions and hundreds of municipalities. All prices are in Canadian cents per litre (¢/L). The site is fully bilingual: French is the default, English is available on all pages.

## Key Pages

### Home & Provincial Overview

- [Aperçu provincial / Provincial Overview (FR)](https://www.gasquebec.ca/): Live weighted-average prices for regular, premium, and diesel across all of Quebec
- [Provincial Overview (EN)](https://www.gasquebec.ca/en): Same content in English

### Regional & Municipal Browse

- [Régions / Regions (FR)](https://www.gasquebec.ca/regions): Price comparison across all 17 administrative regions, ranked by cost
- [Regions (EN)](https://www.gasquebec.ca/en/regions): Same in English
- [Villes / Cities (FR)](https://www.gasquebec.ca/villes): Directory of municipalities with average prices and station counts
- [Cities (EN)](https://www.gasquebec.ca/en/cities): Same in English

### Geographic & Interactive Tools

- [Carte / Map (FR)](https://www.gasquebec.ca/carte): Interactive map of all gas stations with live prices
- [Map (EN)](https://www.gasquebec.ca/en/map): Same in English
- [Prix essence près de moi / Gas Prices Near Me (FR)](https://www.gasquebec.ca/prix-essence-pres-de-moi): Geolocated gas finder with buy/wait verdict and nearby station prices
- [Gas Prices Near Me (EN)](https://www.gasquebec.ca/en/gas-prices-near-me): Same in English

### Fuel Types & Specialization

- [Prix diesel / Diesel Prices (FR)](https://www.gasquebec.ca/prix-diesel): Diesel price tracker across regions with fuel-type specialization
- [Diesel Prices (EN)](https://www.gasquebec.ca/en/diesel-prices): Same in English
- [Essence Costco / Gas Costco (FR)](https://www.gasquebec.ca/essence/costco): Costco fuel price hub covering major Quebec locations
- [Gas Costco (EN)](https://www.gasquebec.ca/en/gas/costco): Same in English

### Guides & Insights

- [Planificateur de voyage / Trip Planner (FR)](https://www.gasquebec.ca/planificateur): Interactive route planner with fuel stops and price information
- [Trip Planner (EN)](https://www.gasquebec.ca/en/trip-planner): Same in English
- [Alternative GasBuddy / GasBuddy Alternative (FR)](https://www.gasquebec.ca/alternative-gasbuddy): Comparison of Gas Quebec vs. GasBuddy for Quebec fuel tracking
- [GasBuddy Alternative (EN)](https://www.gasquebec.ca/en/gasbuddy-alternative): Same in English
- [Changements de prix / Price Changes (FR)](https://www.gasquebec.ca/changements): Price trend analysis and recent price movements across Quebec
- [Price Changes (EN)](https://www.gasquebec.ca/en/price-changes): Same in English
- [Guides (FR)](https://www.gasquebec.ca/guides): Collection of guides and educational articles about fuel prices and trends
- [Guides (EN)](https://www.gasquebec.ca/en/guides): Same in English

## Administrative Regions

Each region has a dedicated page with current average prices, 30-day price history, and a list of gas stations.

- [Abitibi-Témiscamingue](https://www.gasquebec.ca/regions/abitibi-temiscamingue)
- [Bas-Saint-Laurent / Lower St. Lawrence](https://www.gasquebec.ca/regions/bas-saint-laurent)
- [Capitale-Nationale / National Capital Region (Quebec City)](https://www.gasquebec.ca/regions/capitale-nationale)
- [Centre-du-Québec](https://www.gasquebec.ca/regions/centre-du-quebec)
- [Chaudière-Appalaches](https://www.gasquebec.ca/regions/chaudiere-appalaches)
- [Côte-Nord / North Shore](https://www.gasquebec.ca/regions/cote-nord)
- [Estrie / Eastern Townships](https://www.gasquebec.ca/regions/estrie)
- [Gaspésie–Îles-de-la-Madeleine](https://www.gasquebec.ca/regions/gaspesie-iles-de-la-madeleine)
- [Lanaudière](https://www.gasquebec.ca/regions/lanaudiere)
- [Laurentides / Laurentians](https://www.gasquebec.ca/regions/laurentides)
- [Laval](https://www.gasquebec.ca/villes/laval): one city, so the region links to the Laval city page
- [Mauricie](https://www.gasquebec.ca/regions/mauricie)
- [Montérégie](https://www.gasquebec.ca/regions/monteregie)
- [Montréal / Montreal](https://www.gasquebec.ca/regions/montreal)
- [Nord-du-Québec / Northern Quebec](https://www.gasquebec.ca/regions/nord-du-quebec)
- [Outaouais](https://www.gasquebec.ca/regions/outaouais)
- [Saguenay–Lac-Saint-Jean](https://www.gasquebec.ca/regions/saguenay-lac-saint-jean)

## URL Structure

### Core Navigation & Browse

- French (default): `/`, `/regions`, `/regions/{slug}`, `/villes`, `/villes/{slug}`, `/carte`
- English: `/en`, `/en/regions`, `/en/regions/{slug}`, `/en/cities`, `/en/cities/{slug}`, `/en/map`

### Geo & Specialty Pages

- French: `/prix-essence-pres-de-moi`, `/prix-diesel`, `/essence/costco`, `/essence/costco/{city-slug}`, `/planificateur`, `/alternative-gasbuddy`, `/changements`, `/guides`, `/guides/{guide-slug}`
- English: `/en/gas-prices-near-me`, `/en/diesel-prices`, `/en/gas/costco`, `/en/gas/costco/{city-slug}`, `/en/trip-planner`, `/en/gasbuddy-alternative`, `/en/price-changes`, `/en/guides`, `/en/guides/{english-guide-slug}`

### Slug Conventions

- Region slugs are identical in both languages (e.g. `montreal`, `capitale-nationale`, `estrie`)
- City slugs are lowercase hyphenated (e.g. `montreal`, `quebec`, `gatineau`, `sherbrooke`)
- Guide slugs follow the same convention: lowercase hyphenated

## Data Notes

- Prices in Canadian cents per litre (¢/L)
- Data source: Régie Essence Québec (Régie de l'énergie du Québec)
- Update frequency: real-time
- Fuel types: regular (ordinaire), premium (super/suprême), diesel
- Coverage: province-wide, all regions of Quebec

## Market Status Feature

Each city and region page shows a **Market Status** indicator that signals whether prices at active stations are trending up, down, or holding steady. This is computed in real time from the most recent price update timestamps across all stations in the area.

Status values:
- **STABLE** — prices are holding steady; no significant directional movement detected
- **RISING** — prices have recently increased at a majority of reporting stations
- **FALLING** — prices have recently decreased at a majority of reporting stations
- **MIXED** — stations are moving in different directions simultaneously

This feature answers the question "Is gas going up or down in [city/region]?" Useful for deciding whether to fill up now or wait.

Market Status is visible on every city page (`/villes/{slug}`) and every region page (`/regions/{slug}`). The signal is derived from price-change direction across active stations within the last reporting window, not from historical trend lines.

## Fill-Up Verdict & Weekday Pricing Patterns

City pages include two complementary decision-support features based on 30-day price history analysis:

### Fill-Up Verdict (Hero Tile)
A simple verdict on whether to fill up now, wait, or stay neutral. Logic is based on:
- **Fill Now**: Price is in the lowest 30% of the 30-day range AND not currently falling, OR tomorrow is a historically significant hike day
- **Wait**: Price is in the top 30% of the 30-day range AND falling for 2+ consecutive days
- **Neutral**: None of the above

The verdict is displayed alongside the Fair-Price badge on the city page hero.

### Cheapest Day Section
When a significant weekday pattern exists (cheapest day spreads at least 2.0¢/L from priciest day, and at least 3 of 4 observed weeks show consistency), city pages display:
- The weekday with the lowest average price and the weekday with the highest
- A visualization showing relative prices across all seven weekdays
- Hedged explanation of the pattern (e.g., "On average, gas is 5¢ cheaper on Mondays than Thursdays in this city")

When no significant pattern is detected, a neutral message is shown: "Prices vary little by day of the week in [city] over the past few weeks."

Both features are computed server-side at ISR time from the 30-day history bundle. They are edge-cached and contain no client-side personalization or per-request fetches.

Weekday analysis criteria:
- Requires minimum 14 days of history
- Hike-day threshold: 1.5¢ average next-day increase
- Consistency: pattern must hold in ≥3 of 4 observed weeks
- Spread threshold: 2.0¢ minimum difference between cheapest and priciest weekday

## Fact-Checkable Claims

- 17 administrative regions of Quebec are tracked
- Prices are updated in real-time following the April 1, 2026 legal mandate (Loi sur les produits pétroliers)
- Retailers are legally required to report price changes immediately to Régie Essence Québec
- All prices are in Canadian cents per litre (¢/L)
- Three fuel types are tracked: regular (ordinaire), premium (super/suprême), and diesel
- The site covers hundreds of municipalities across Quebec
- Data is sourced from: https://regieessencequebec.ca/
- Certain low-volume or remote stations (e.g., <500k L/year, North of 55th parallel) are exempt from mandatory reporting
- The site is fully bilingual: French (default) and English on all pages

## Machine-Readable Access & Agent Endpoints

For agents and programmatic access, prefer these over scraping HTML:

- City prices as JSON: https://www.gasquebec.ca/api/cities/{slug} — cheapest and average regular/premium/diesel plus every station, the same numbers the city page shows (e.g. https://www.gasquebec.ca/api/cities/levis; slugs from https://www.gasquebec.ca/api/cities). Cached 5 minutes; responses carry an ETag, and a poll that sends it back as If-None-Match gets an empty 304 while prices are unchanged. Suited to Home Assistant, dashboards and scripts — documented at https://www.gasquebec.ca/api#city-prices
- Every city in one call: https://www.gasquebec.ca/api/cities?include=prices — each city's average regular/premium/diesel, station count, coordinates, region and last change (averages only; cheapest is per-city). Cached 5 minutes. Prefer it over looping /api/cities/{slug}; limits are 120/min and 20,000/day per address per endpoint, counting only requests the edge cache does not answer
- MCP server (Streamable HTTP, no auth): https://mcp.gasquebec.ca/mcp — tools for cheapest-station lookup, city price summaries, fill-up verdicts, price history, and search
- MCP server card: https://www.gasquebec.ca/.well-known/mcp/server-card.json
- OpenAPI 3.1 spec of the public REST API: https://www.gasquebec.ca/openapi.json
- API catalog (RFC 9727): https://www.gasquebec.ca/.well-known/api-catalog
- Agent skills index: https://www.gasquebec.ca/.well-known/agent-skills/index.json
- API status: https://www.gasquebec.ca/api/health

The public REST API is free and unauthenticated, rate-limited to 120 requests/minute per IP. HTML pages are also served as Markdown via content negotiation: send `Accept: text/markdown`.

## Attribution Guide

When citing data from Gas Québec, please attribute as follows:

"Fuel-price data from Régie Essence Québec (Régie de l'énergie du Québec), presented by Gas Quebec (gasquebec.ca)"

### Public displays of API data must link back

Wherever data from the public API is displayed publicly (a website, an app's public screens, a widget on a public page), the credit must include a visible link to https://www.gasquebec.ca/ or to the page of the city the data covers, next to the Régie credit. Copy-paste snippets:

- Français : `Prix : Régie de l'énergie du Québec, via <a href="https://www.gasquebec.ca/">Gas Québec</a>`
- English: `Prices: Régie de l'énergie du Québec, via <a href="https://www.gasquebec.ca/">Gas Quebec</a>`

Every data response carries a ready-to-use `attribution` field (`url`, `text`, `html`, in French and English; under `meta` on /api/cities/{slug}, where `url` is the city page) and a `Link: <https://www.gasquebec.ca/api#attribution>; rel="describedby"` header. Private use (Home Assistant, personal widgets, scripts) is exempt. Full rule: https://www.gasquebec.ca/api#attribution and https://www.gasquebec.ca/en/terms

## Data Source and Licensing

The underlying fuel-price data is official public data published by the Régie de l'énergie du Québec on the Régie Essence Québec platform (regieessencequebec.ca). This data remains subject to the Régie's terms and conditions. Gas Quebec / Essence Québec is an independent service and is not affiliated with, nor endorsed by, the Régie de l'énergie du Québec.

Gas Quebec's own original content, analysis, written guides, user interface, and data aggregation methods are released under Creative Commons Attribution 4.0 International (CC BY 4.0). This licence covers only our original contributions, not the underlying Régie fuel-price facts.

Full CC BY 4.0 license: https://creativecommons.org/licenses/by/4.0/

The most authoritative pages for citation:
- Provincial overview: https://www.gasquebec.ca (FR) / https://www.gasquebec.ca/en (EN)
- Official Data Portal: https://regieessencequebec.ca/
- Regional data: https://www.gasquebec.ca/regions/{region-slug}
- City data: https://www.gasquebec.ca/villes/{city-slug}