Catalog / 99 Ranch Market Data

99 Ranch Market Data API

99ranch.com

Read-only live product and store data from 99 Ranch Market. Product search, detail, and store-radius routes use the site's observed JSON endpoints and do not scrape rendered HTML. Search pricing and availability are store-contextual; the site uses store IDs for product context and ZIP/radius for stores.

  • shopping
  • 99 Ranch Market
  • groceries
  • products
  • stores
3 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 Ranch Market Data 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 live 99 Ranch product records by keyword and store context. Results and totals come from the site's JSON search service.

Search text matched against product names and descriptions.

Optional parameters 4

1-based source page number.

99 Ranch store ID used for price and availability context.

ZIP code retained as the caller's store-selection context.

Products per page; the public route caps this at the requested maximum of 28.

View call pricing
cURL · Search products
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/d596500a-3695-44af-8be1-7161fb253419/v1/products/search' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY" \
  --data-urlencode 'keyword=rice'

Endpoints

Inputs and response fields for every endpoint in this API.

GETSearch products/v1/products/search

Search live 99 Ranch product records by keyword and store context. Results and totals come from the site's JSON search service.

Input

keywordRequiredQuery · string

Search text matched against product names and descriptions.

Example: rice

pageOptionalQuery · integer, min: 1, default: 1

1-based source page number.

Example: 1

store_idOptionalQuery · string, default: 8899

99 Ranch store ID used for price and availability context.

Example: 8899

zip_codeOptionalQuery · string, default: 91754

ZIP code retained as the caller's store-selection context.

Example: 91754

page_sizeOptionalQuery · integer, min: 1, max: 28, default: 28

Products per page; the public route caps this at the requested maximum of 28.

Example: 28

Response

pageinteger
totalinteger
productsobject[]
products[].namestring
products[].brand?string | null
products[].image?string | null
products[].price?number | null
products[].weight?string | null
products[].in_stockboolean
products[].product_idinteger
products[].availability?integer | number | null
page_sizeinteger
total_pagesinteger
has_next_pageboolean

Fields marked ? are optional.

GETProduct detail/v1/products/{product_id}

Return live product images, variants, ratings, description, and backend/display category paths for a product ID from search.

Input

product_idRequiredPath · integer

Numeric product ID returned by search.

Example: 1601108

store_idOptionalQuery · string, default: 8899

99 Ranch store ID used for the product context.

Example: 8899

Response

namestring
brand?string | null
imagesstring[]
categorystring[]
variantsobject[]
variants[].upc?string | null
variants[].name?string | null
variants[].image?string | null
variants[].price?number | null
variants[].weight?number | null
variants[].variant_id?string | null
variants[].weight_unit?string | null
variants[].availability?integer | number | null
avg_rating?number | null
product_idinteger
descriptionstring
review_countinteger
category_viewstring[]

Fields marked ? are optional.

GETSearch stores/v1/stores/search

Find live 99 Ranch stores around a ZIP code, ordered by source distance, with contact, coordinates, and online/offline flags.

Input

zip_codeRequiredQuery · string

Five-digit US ZIP code.

Example: 91754

distanceOptionalQuery · integer, min: 0, default: 50

Search radius in miles passed to the source store locator.

Example: 50

Response

totalinteger
storesobject[]
stores[].fax?string | null
stores[].city?string | null
stores[].namestring
stores[].email?string | null
stores[].state?string | null
stores[].onlineboolean
stores[].addressstring
stores[].offlineboolean
stores[].latitude?number | null
stores[].store_idinteger
stores[].zip_code?string | null
stores[].longitude?number | null
stores[].telephone?string | null
stores[].time_zone?string | null
stores[].distance_miles?number | null
distanceinteger
zip_codestring

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.