BMW USA
BMW US car shopping: the Build Your Own configurator and its option pricing, live VIN-level new and Certified Pre-Owned dealer inventory near a ZIP, the…
BMW US car shopping: the Build Your Own configurator and its option pricing, live VIN-level new and Certified Pre-Owned dealer inventory near a ZIP, the model lineup with trims and MSRP, current lease and finance offers, the dealer locator, plus recall lookup by VIN, accessories and owner's manuals.
Domain: bmwusa.com
Also known as: BMW, BMW USA, BMW of North America, bmwusa.com, BMW US
Call it directly
bowmark.providers.bmwusa.buildVehicle(modelCode: string, optionCodes?: string[]): Promise<BmwusaBuiltVehicle>
bowmark.providers.bmwusa.searchCertifiedPreOwned(zip: string, options?: { radius?: number; limit?: number; model?: string; minYear?: number; maxYear?: number; maxPrice?: number; maxOdometer?: number }): Promise<BmwusaCpoVehicle[]>
bowmark.providers.bmwusa.getModel(path: string): Promise<BmwusaModel>
bowmark.providers.bmwusa.listOffers(zip: string): Promise<BmwusaOffersResult>
bowmark.providers.bmwusa.listModels(): Promise<BmwusaModelListing[]>Functions
| Function | What it does |
|---|---|
buildVehicle | Runs BMW's own Build Your Own configurator for a model code (read off /all-bmws.html's build-your-own.html#/studio/{code} links) applying zero or more option codes (paint, wheels, trim,… |
searchCertifiedPreOwned | Searches BMW's live Certified Pre-Owned inventory near a 5-digit ZIP code, server-side scoped to CPO-only stock (BMW's own 'BMW Certified' facet — plain used cars are excluded), returning… |
getModel | Reads one BMW model's body-style page (path is the segment of the site's own /vehicles/...html URL, e.g. 'x-models/x5', '2-series/coupe' — read off bmwusa.com's own navigation or… |
listOffers | Lists BMW's current US lease and finance offers for a 5-digit ZIP code (resolved server-side to a sales region, since the site's own offer objects carry per-region eligibility) — every… |
listModels | Lists BMW's current US lineup — every model BMW sells, with its bmwusa.com model-overview URL, body style, powertrain category (electric / plug-in hybrid / performance / gasoline) and… |
Types
interface BmwusaBuiltVehicleOption {
code: string;
name: string;
price: number;
}
interface BmwusaBuiltVehicle {
modelCode: string;
modelName: string;
series: string;
bodyStyle: string;
year: number;
basePrice: number;
destinationAndHandling: number;
selectedOptions: BmwusaBuiltVehicleOption[];
totalPrice: number;
}
interface BmwusaCpoDealer {
name: string;
url: string;
city: string;
state: string;
postalCode: string;
distance: number;
}
interface BmwusaCpoVehicle {
vin: string;
year: number;
model: string;
trim: string;
bodyStyle: string;
exteriorColor: string;
interiorColor: string;
odometer: number;
price: number;
drivetrain: string;
fuelType: string;
vdpUrl: string;
photos: string[];
dealer: BmwusaCpoDealer;
}
interface BmwusaCpoSearchOptions {
radius?: number;
limit?: number;
model?: string;
minYear?: number;
maxYear?: number;
maxPrice?: number;
maxOdometer?: number;
}
interface BmwusaModelTrim {
name: string;
modelCode: string | null;
zeroToSixty: number | null;
horsepower: number | null;
startingMsrp: number | null;
engineType: string | null;
drivetrain: string | null;
transmission: string | null;
fuelType: string | null;
fuelEfficiency: { city: number | null; highway: number | null; combined: number | null; unit: string } | null;
seatingCapacity: number | null;
}
interface BmwusaModel {
name: string;
series: string;
url: string;
trims: BmwusaModelTrim[];
}
interface BmwusaOfferTier {
apr: number;
months: number;
}
interface BmwusaLeaseOffer {
code: string;
description: string;
monthlyPayment: number;
term: number;
msrp: number;
downPayment: number;
acquisitionFee: number;
dueAtSigningExceptNy: number | null;
loyaltyCredit: number | null;
dealerContribution: string | null;
allowedMiles: number | null;
chargePerExcessMile: number | null;
endOfTermPurchaseOption: number | null;
startDate: string;
endDate: string;
}
interface BmwusaFinanceOffer {
code: string;
description: string;
tiers: BmwusaOfferTier[];
loyaltyCredit: number | null;
startDate: string;
endDate: string;
}
interface BmwusaOffer {
modelCode: string;
modelName: string;
series: string;
bodyStyle: string;
msrp: number;
lease: BmwusaLeaseOffer | null;
finance: BmwusaFinanceOffer | null;
}
interface BmwusaOffersResult {
region: string;
offers: BmwusaOffer[];
}
interface BmwusaModelListing {
name: string;
url: string;
bodyStyle: string | null;
powertrain: "electric" | "plugInHybrid" | "performance" | "gasoline" | null;
msrpFrom: number | null;
msrpTo: number | null;
trimCount: number;
}