Bowmark AIdocs

GasBuddy

GasBuddy's real, crowdsourced per-station gas prices — runs the site's own ZIP-radius search and returns currently-reported stations (brand, address,…

GasBuddy's real, crowdsourced per-station gas prices — runs the site's own ZIP-radius search and returns currently-reported stations (brand, address, regular-gas price, how long ago it was reported) sorted cheapest first.

Domain: gasbuddy.com

Also known as: GasBuddy, Gas Buddy

Call it directly

bowmark.providers.gasbuddy.findCheapestNearby(args: GasbuddyFindCheapestNearbyArgs): Promise<GasbuddyStation[]>

Functions

FunctionWhat it does
findCheapestNearbyRuns GasBuddy's own ZIP-radius station search and returns real, currently-reported stations (brand, address, regular-gas price, when it was reported), sorted cheapest first.

Types

interface GasbuddyFindCheapestNearbyArgs {
  zip: string;      // a 5-digit US ZIP code, e.g. "78701"
  limit?: number;    // default 10, clamped to [1, 30]
}

interface GasbuddyStation {
  brand: string;
  address: string;             // "<street>, <city>, <state>"
  price: number | null;        // real, current regular-gas price; null if no recent report
  reportedAgo: string | null;  // e.g. "2 Hours Ago", or null alongside a null price
  url: string;                  // this exact station's own GasBuddy URL
}