99 Ranch Market Data API
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.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn 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 keySign 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.
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 · stringSearch text matched against product names and descriptions.
Example: rice
pageOptionalQuery · integer, min: 1, default: 11-based source page number.
Example: 1
store_idOptionalQuery · string, default: 889999 Ranch store ID used for price and availability context.
Example: 8899
zip_codeOptionalQuery · string, default: 91754ZIP code retained as the caller's store-selection context.
Example: 91754
page_sizeOptionalQuery · integer, min: 1, max: 28, default: 28Products per page; the public route caps this at the requested maximum of 28.
Example: 28
Response
pageintegertotalintegerproductsobject[]products[].namestringproducts[].brand?string | nullproducts[].image?string | nullproducts[].price?number | nullproducts[].weight?string | nullproducts[].in_stockbooleanproducts[].product_idintegerproducts[].availability?integer | number | nullpage_sizeintegertotal_pagesintegerhas_next_pagebooleanFields 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 · integerNumeric product ID returned by search.
Example: 1601108
store_idOptionalQuery · string, default: 889999 Ranch store ID used for the product context.
Example: 8899
Response
namestringbrand?string | nullimagesstring[]categorystring[]variantsobject[]variants[].upc?string | nullvariants[].name?string | nullvariants[].image?string | nullvariants[].price?number | nullvariants[].weight?number | nullvariants[].variant_id?string | nullvariants[].weight_unit?string | nullvariants[].availability?integer | number | nullavg_rating?number | nullproduct_idintegerdescriptionstringreview_countintegercategory_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 · stringFive-digit US ZIP code.
Example: 91754
distanceOptionalQuery · integer, min: 0, default: 50Search radius in miles passed to the source store locator.
Example: 50
Response
totalintegerstoresobject[]stores[].fax?string | nullstores[].city?string | nullstores[].namestringstores[].email?string | nullstores[].state?string | nullstores[].onlinebooleanstores[].addressstringstores[].offlinebooleanstores[].latitude?number | nullstores[].store_idintegerstores[].zip_code?string | nullstores[].longitude?number | nullstores[].telephone?string | nullstores[].time_zone?string | nullstores[].distance_miles?number | nulldistanceintegerzip_codestringFields 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.
An account is required to submit an extension. Prepare your request, then sign in to build.