Catalog / 99 Bikes Public Catalog

99 Bikes Public Catalog API

99bikes.com.au

Live read-only data from 99 Bikes' public DiscoveryOS/Shopify JSON, inventory view, and MCP FAQ surfaces. Search and collection totals are DiscoveryOS indexed totals, not a claim about the larger Shopify catalog. Stores is a structured Click & Collect identity subset; workshop prices, help categories/articles, and store hours are documented as unavailable where the source exposes them only through HTML/JSON-LD.

  • shopping
  • bicycles
  • retail
  • inventory
6 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the 99 Bikes Public Catalog API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Search Products

Catalog keyword.

Optional parameters 3

1-based page number.

relevance, price_asc, price_desc, or popularity.

DiscoveryOS page size sent as its size parameter.

View call pricing
cURL · Search products
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/1ff945e5-0292-4fa5-ae4d-25a3fda90477/v1/products/search' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY" \
  --data-urlencode 'query=helmet'

Endpoints

Inputs and response fields for every endpoint in this API.

GETSearch products/v1/products/search

Search Products

Input

queryRequiredQuery · string

Catalog keyword.

Example: helmet

pageOptionalQuery · integer, min: 1, default: 1

1-based page number.

Example: 1

sort_byOptionalQuery · string, default: relevance

relevance, price_asc, price_desc, or popularity.

Example: relevance

page_sizeOptionalQuery · integer, min: 1, default: 36

DiscoveryOS page size sent as its size parameter.

Example: 36

Response

pageinteger
querystring
productsobject[]
products[].idstring
products[].urlstring
products[].type?string | null
products[].brand?string | null
products[].titlestring
products[].handlestring
products[].variants?object[]
products[].variants[].idstring
products[].variants[].sku?string | null
products[].variants[].price?integer | null
products[].variants[].titlestring
products[].variants[].available?boolean | null
products[].variants[].compare_at_price?integer | null
products[].image_url?string | null
products[].collections?string[]
products[].discount_amountinteger
products[].discount_percent?number, default: 0
page_sizeinteger
total_resultsinteger

Fields marked ? are optional.

GETGet collection products/v1/collections/{collection_handle}/products

Get Collection Products

Input

collection_handleRequiredPath · string

Shopify collection handle.

Example: helmets

pageOptionalQuery · integer, min: 1, default: 1

1-based collection JSON page.

Example: 1

sort_byOptionalQuery · string, default: popularity

popularity, price_asc, or price_desc.

Example: popularity

page_sizeOptionalQuery · integer, min: 1, default: 36

DiscoveryOS page size sent as its size parameter.

Example: 36

Response

pageinteger
productsobject[]
products[].idstring
products[].urlstring
products[].type?string | null
products[].brand?string | null
products[].titlestring
products[].handlestring
products[].variants?object[]
products[].variants[].idstring
products[].variants[].sku?string | null
products[].variants[].price?integer | null
products[].variants[].titlestring
products[].variants[].available?boolean | null
products[].variants[].compare_at_price?integer | null
products[].image_url?string | null
products[].collections?string[]
products[].discount_amountinteger
products[].discount_percent?number, default: 0
page_sizeinteger
total_resultsinteger
available_filtersobject
available_filters.brands?string[]
available_filters.colours?string[]
available_filters.categories?string[]
collection_handlestring
total_results_semantics?string, default: DiscoveryOS indexed subset for this query

Fields marked ? are optional.

GETGet stores/v1/stores

Get Stores

Input

No input parameters.

Response

scope?string, default: click_and_collect identity subset
storesobject[]
stores[].idstring
stores[].city?string | null
stores[].namestring
stores[].email?string | null
stores[].phone?string | null
stores[].state?string | null
stores[].country?string, default: AU
stores[].latitude?number | null
stores[].longitude?number | null
stores[].postal_code?string | null
stores[].address_line_1?string | null
stores[].address_line_2?string | null
stores[].store_page_url?string | null
limitation?string, default: The structured inventory source supplies store names and Shopify location IDs only; address, contact, coordinates and canonical store URLs are not available in this source.
total_storesinteger

Fields marked ? are optional.

GETGet workshop services/v1/workshop

Get Workshop Services

Input

No input parameters.

Response

urlstring
titlestring
limitation?string, default: The live Shopify page exposes package/service prices only in HTML; the structured page JSON contains metadata only.
descriptionstring
service_packages?object[]
service_packages[].tier_namestring
service_packages[].included_services?string[]
individual_services?object[]
individual_services[].namestring
individual_services[].category?string | null
individual_services[].club_price?integer | null
individual_services[].full_price?integer | null
individual_services[].with_service_price?integer | null

Fields marked ? are optional.

GETGet help centre/v1/help-centre

Get Help Centre

Input

No input parameters.

Response

urlstring
faqsobject[]
faqs[].answerstring
faqs[].questionstring
titlestring
categories?object[]
categories[].articles?object[]
categories[].category_namestring
limitation?string, default: FAQ answers come from the structured Shopify MCP tool; BetterDocs category and article inventory is HTML-only and therefore omitted.

Fields marked ? are optional.

GETGet store stock/v1/products/stock

Get Store Stock

Input

urlOptionalQuery · string | null

99 Bikes product URL; takes precedence over product_handle.

Example: https://99bikes.com.au/products/garmin-edge-840-touchscreen-bike-computer

storeOptionalQuery · string | null

Case-insensitive store-name substring.

Example: Midland

variantOptionalQuery · string | null

Case-insensitive variant-title substring.

Example: MD

product_handleOptionalQuery · string | null

Shopify product handle alternative to url.

Example: garmin-edge-840-touchscreen-bike-computer

Response

variantsobject[]
variants[].price?integer | null
variants[].storesobject[]
variants[].stores[].namestring
variants[].stores[].location_idstring
variants[].stores[].stock_labelstring
variants[].stores[].stock_statusinteger
variants[].stores[].transfer_time?integer[]
variants[].stores[].quantities_available?integer[]
variants[].stores[].nearest_available_store?object
variants[].stores[].nearest_available_store.namestring
variants[].stores[].nearest_available_store.distance_km?number | integer | null
variants[].stores[].nearest_available_store.location_idstring
variants[].variant_idstring
variants[].stores_totalinteger
variants[].variant_titlestring
product_urlstring
product_titlestring
product_handlestring
variants_totalinteger
failed_variantsobject[]
failed_variants[].variant_idstring
failed_variants[].variant_titlestring
failed_variants[].upstream_statusinteger | string
variants_matchedinteger
variants_truncatedboolean

Fields marked ? are optional.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.