Skip to main content

Honda & Acura US Public API — Platform Overview

Honda and Acura share the same underlying Hawk Platform backend — the same endpoint structure, field naming conventions, and response structures — deployed at two separate domains:

BrandDomain
Hondaautomobiles.honda.com
Acurawww.acura.com

All endpoints are unauthenticated GET requests returning JSON. Per-endpoint documentation:

Postman: Honda public APIs · Acura public APIs


Endpoint Overview

Both brands hit the same routes on their respective hosts; the only per-brand input is productDivisionCode (A = Honda, B = Acura) on the dealer endpoint. The ingestion uses one shared client per endpoint, parameterized by host/division.

EndpointHondaAcura
Dealer LocatorGET /platform/api/v1/dealer?productDivisionCode=AGET /platform/api/v1/dealer?productDivisionCode=B
Inventory + DealersGET /platform/api/v3/inventoryAndDealersGET /platform/api/v3/inventoryAndDealers
Vehicle DetailsGET /platform/api/v1/vehicles/details/{year}/{series}GET /platform/api/v1/vehicles/details/{year}/{series}
SpecialsGET /platform/api/v1/specialsGET /platform/api/v1/specials
RAQ TaxonomyGET /platform/api/v1/vehicles/taxonomy/raqGET /platform/api/v1/vehicles/taxonomy/raq
ConfiguratorGET /platform/api/v1/vehicles/{year}/{SERIES}/configurator

Bot Protection

All Honda and Acura endpoints are protected by Akamai Bot Manager. Plain HTTP clients receive 403 or 429 responses. Successful access requires:

  1. Browser TLS impersonation via curl_cffi with a browser impersonation profile
  2. Seed-URL warmup — an initial GET to the endpoint-specific tool page to obtain ak_bmsc / bm_sv session cookies
  3. Subsequent API requests must carry those session cookies

The protection operates at the TLS fingerprint level; changing User-Agent alone is insufficient.

Seed URLs by endpoint:

EndpointHonda seed URLAcura seed URL
Dealer Locator…/tools/find-a-dealer…/dealer-locator-inventory
Inventory + Dealers…/tools/search-inventory…/dealer-locator-inventory
Vehicle Details…/{series} (e.g. /civic-sedan)…/{series} (e.g. /rdx)
Specials…/ (home)…/ (home)
RAQ Taxonomy…/tools/build-and-price…/tools/build-and-price-luxury-vehicles-selection-page
CDN-bypass exception

The RAQ taxonomy catalog endpoint (both brands) is served from CDN cache and does not trigger a bot challenge on cache hits, provided Referer and sec-fetch-* headers are present. No seed-URL cookie warmup is needed for it.


Model Series

Honda 2026

accord-sedan, civic-hatchback, civic-sedan, civic-si-sedan, civic-type-r,
cr-v, cr-v-fcev, hr-v, odyssey, passport, pilot, prelude, prologue, ridgeline

14 active series. Used as modelGroup in inventory and {series} in vehicle details.

Acura 2026

SlugModel
adxADX
integraIntegra
mdxMDX
rdxRDX

4 active series. Configurator uses the uppercase slug (e.g. INTEGRA, RDX).


Dagster Asset Keys

Honda

AssetKey
Raw dealer locatorhonda/us/raw/honda_auto_api_dealers
Raw inventory + dealershonda/us/raw/honda_auto_api_inventory_and_dealers
Raw vehicle detailshonda/us/raw/honda_auto_api_vehicles_details
Raw specialshonda/us/raw/honda_auto_api_specials
Raw RAQ taxonomyhonda/us/raw/honda_auto_api_taxonomy_raq

Acura

AssetKey
Raw dealer locatorhonda/us/raw/acura_auto_api_dealers
Raw inventory + dealershonda/us/raw/acura_auto_api_inventory_and_dealers
Raw vehicle detailshonda/us/raw/acura_auto_api_vehicles_details
Raw configuratorhonda/us/raw/acura_auto_api_configurator
Raw specialshonda/us/raw/acura_auto_api_specials
Raw RAQ taxonomyhonda/us/raw/acura_auto_api_taxonomy_raq

Consolidated (shared)

AssetKey
Consolidated dealershonda/us/consolidated/dealers
Consolidated inventoryhonda/us/consolidated/inventory
Consolidated modelshonda/us/consolidated/models
Consolidated featureshonda/us/consolidated/features