Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Gas Quebec public Search API
version: 1.6.0
summary: Live Quebec fuel prices (regular, premium, diesel) by station, city, and region.
description: 'Public, unauthenticated read API behind gasquebec.ca. All prices are in Canadian cents per litre (¢/L). Data is sourced from Régie Essence Québec (Régie de l''énergie du Québec) and must be attributed as: "Fuel-price data from Régie Essence Québec (Régie de l''énergie du Québec), presented by Gas Quebec (gasquebec.ca)". Wherever API data is displayed publicly (a website, an app''s public screens, a widget on a public page), that credit must include a visible link to https://www.gasquebec.ca/ or to the page of the city the data covers. Every data response carries a ready-to-use `attribution` field ({ url, text, html }, French and English) and a `Link: ; rel="describedby"` header. Copy-paste snippet: `Prix : Régie de l''énergie du Québec, via Gas Québec` (EN: `Prices: Régie de l''énergie du Québec, via Gas Quebec`). Private use (Home Assistant, personal widgets, scripts) is exempt from the link. Every endpoint is rate-limited to 120 requests/minute per IP and returns 429 with a Retry-After header when exceeded.'
termsOfService: https://www.gasquebec.ca/en/terms
contact:
url: https://www.gasquebec.ca/contact
license:
name: CC BY 4.0 (Gas Quebec original content only; underlying price facts remain subject to the Régie's terms)
url: https://creativecommons.org/licenses/by/4.0/
servers:
- url: https://www.gasquebec.ca
tags:
- name: Search
paths:
/api/search:
get:
operationId: search
summary: Search cities, regions, and stations by name
parameters:
- name: q
in: query
required: true
schema:
type: string
- name: lang
in: query
schema:
type: string
enum:
- fr
- en
default: fr
responses:
'200':
description: Matching cities, regions, and stations with links
headers:
Link:
description: 'Points at the attribution rule: <https://www.gasquebec.ca/api#attribution>; rel="describedby"'
schema:
type: string
'429':
$ref: '#/components/responses/RateLimited'
tags:
- Search
components:
responses:
RateLimited:
description: Rate limit exceeded. Honour the Retry-After header. Public data endpoints allow 120 requests/minute and 20,000/day per address, counting only requests the edge cache does not answer; the daily 429 adds a `hint` and a `Retry-After` to midnight UTC.