Ford APIford.ca ↗
Access current Ford Canada financing APR rates, lease terms, cash rebates, and incentives by model and trim via the ford.ca offers API.
What is the Ford API?
The Ford Canada Offers API covers 2 endpoints that return current vehicle deals from ford.ca, including per-trim financing APR rates, lease terms, cash incentives, vehicle images, and links to the Ford Canada configurator. The get_all_offers endpoint aggregates deals across Ford's full Canadian lineup in a single call, while get_model_offers returns detailed trim-level breakdowns for a specific model and year.
curl -X GET 'https://api.parse.bot/scraper/490087e5-5730-4ab1-983c-714064e76b22/get_all_offers?model=F-150&language=EN&postal_code=L6J5E4' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace ford-ca-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Ford Canada Vehicle Offers API — bounded, re-runnable walkthrough."""
from parse_apis.ford_canada_vehicle_offers_api import FordCanada, Model, Language, ModelNotFound
client = FordCanada()
# List all current deals for the F-150, capped at 5 items.
for deal in client.deals.list(model=Model.F_150, language=Language.EN, limit=5):
print(deal.model_name, deal.trim, deal.model_year)
# Get detailed offers for a specific model.
offer = client.offers.get(model=Model.BRONCO_SPORT)
print(offer.model_name, offer.model_year, offer.vehicle_url)
for trim in offer.trims[:3]:
print(f" {trim.trim}: {len(trim.financing)} financing, {len(trim.lease)} lease programs")
# Typed error handling: catch an invalid model name.
try:
client.offers.get(model="InvalidModel123")
except ModelNotFound as exc:
print(f"Model not found: {exc.model}")
print("exercised: deals.list / offers.get / ModelNotFound error handling")
Get all current vehicle deals and offers across Ford Canada models. Returns financing details (APR, terms), lease details (APR, terms), cash incentives/rebates, vehicle images, and vehicle page URLs for each model/trim combination. When model is omitted, queries a default set of popular models (F-150, Maverick, Bronco, Bronco Sport, Explorer, Escape, Ranger, F-150 Lightning, Mustang Mach-E). Postal code affects province-specific incentive availability.
| Param | Type | Description |
|---|---|---|
| model | string | Filter to a specific model name. If empty, returns all models. |
| language | string | Language for offer details: EN or FR |
| postal_code | string | Canadian postal code for regional offers (affects province-specific incentives). Format: 6 alphanumeric characters without space (e.g. L6J5E4). |
{
"type": "object",
"fields": {
"deals": "array of deal objects with: model_name, model_year, trim, financing, lease, cash_incentives, vehicle_image, vehicle_url, build_and_price_url, offer_start_date, offer_end_date",
"language": "string - language used for the query",
"postal_code": "string - postal code used for the query",
"total_deals": "integer - total number of deal entries returned"
}
}About the Ford API
What the API Returns
Both endpoints expose structured incentive data drawn from ford.ca's current offers. Each deal object includes model_name, model_year, trim, a financing array (APR offer objects with term details), a lease array, cash_incentives, a vehicle_image URL, and a vehicle_url pointing to the relevant ford.ca model page. All data is scoped to Canadian buyers and reflects active regional campaigns.
Filtering and Parameters
get_all_offers accepts an optional model parameter to narrow results to a single nameplate (e.g., F-150, Bronco Sport, Maverick), a language parameter (EN or FR) for bilingual offer text, and a postal_code for province-specific incentive calculation. The total_deals integer in the response tells you exactly how many deal entries were returned. get_model_offers adds a required model parameter and an optional year to target a specific model year; it also returns a model_offers object containing model-level campaigns separate from trim-level offers, plus a build_and_price_url for the Ford configurator.
Trim-Level Detail
get_model_offers returns a trims array where each entry carries its own financing, lease, and cash_incentives arrays. This makes it straightforward to compare, for example, the financing APR on an F-150 XLT versus an F-150 Lariat without making multiple calls. The vehicle_image field returns a full URL to the campaign image for that model, or null if none is currently active.
Coverage Scope
All offers reflect the Canadian market only. Regional variation is handled through the postal_code parameter, which shifts the response toward province-specific incentives where they differ from the national baseline. Both EN and FR language responses are supported, matching ford.ca's bilingual content.
The Ford API is a managed, monitored endpoint for ford.ca — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ford.ca changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ford.ca API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display current Ford Canada financing APR and lease rates on a Canadian automotive comparison site
- Alert buyers when cash rebates or delivery allowances change for a specific model like the Ranger or Explorer
- Build a trim comparison tool showing financing vs. lease costs side-by-side using the
trimsarray - Populate a regional deals widget by passing a user's postal code to surface province-specific incentives
- Generate bilingual (EN/FR) offer summaries for Quebec-focused automotive content
- Track historical changes in Ford Canada incentive campaigns by polling
get_all_offerson a schedule - Link directly to the Ford Canada build-and-price configurator using the
build_and_price_urlfield
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Ford Canada provide an official developer API for its offers data?+
What does `get_model_offers` return that `get_all_offers` does not?+
get_model_offers returns a model_offers object containing model-level campaign financing, lease, and cash incentive arrays that sit above the trim level. It also returns a build_and_price_url for the Ford Canada configurator and supports a year parameter to target a specific model year. get_all_offers aggregates across models but does not expose those model-level campaign objects or the configurator URL.