Skip to content
Rider Height
<- Home

Public read API

Read bike geometry and fit scores as JSON.

Rider Height's public API exposes the same catalog and fit scoring surface used by the embed widgets. It is read-only, versioned, cacheable, and rate limited.

Version

v1

Rate limit

120 requests / minute / IP

Caching

s-maxage 300, stale 3600

GET/api/v1/bikes

List public bike summaries. Supports search, category filtering, and a capped limit.

q=yamahacategory=nakedlimit=25
Open sample JSON
GET/api/v1/bikes/{slug}

Read one bike with manufacturer, public image assets, geometry measurements, field provenance, verification state, and web/embed links.

Open sample JSON
GET/api/v1/fit

Score one to five bikes for a rider height, inseam, and optional weight, including bike image and API/web/embed links for each result.

slugs=slug-a,slug-bheightMm=1830inseamMm=855weightKg=78
Open sample JSON

Response contract

  • Successful responses use meta and data top-level keys.
  • Errors use error: { code, message } with the relevant HTTP status.
  • All API responses include `X-API-Version: v1`.
  • Rate-limited responses return `429` plus `Retry-After` and rate-limit headers.
  • Bike detail assets expose public image URLs, source/license hints, dimensions, content type, and public metadata; storage bucket/key internals are omitted.
  • Fit result rows include score data plus imageUrl and link metadata for rendering bike cards without a follow-up detail request.