Sprouts Search API searches products at Sprouts Farmers Market. Each item has the current price, the regular price, the sale price when the item is on sale, the unit price (for example $0.06/oz), size, brand, UPC, category, image, stock, rating, diet badges and a nutrition summary.
Prices and stock depend on the store. Pass store_id (exact) or zip (one of 85260, 90210, 77002, 30301, 80202). Without both, the API uses shop 393864 (Scottsdale, AZ). A ZIP code outside the list returns 422: use store_id. A store id that does not exist returns 422 as well.
Results keep the ranking of the Sprouts site. total_results counts every hit of the query (up to a few hundred). A page past the end is an empty list with the total. Costs 1 credit per successful request. Empty results and failed requests are free.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
4 optional filters available.
string
Required
Search text, 1 to 120 characters, for example milk.
coffee shops
string
Optional
Number of a Sprouts shop, 3 to 9 digits, for example 393864. Prices and stock follow the shop. It wins over zip. Default is shop 393864 (Scottsdale, AZ).
1234567890
string
Optional
One of the supported ZIP codes: 85260, 90210, 77002, 30301, 80202. It selects the shop that serves this ZIP code. Other ZIP codes return 422: use store_id.
example
integer
Optional
One-based page number, 1 to 500 (default 1).
1
integer
Optional
Results per page, 1 to 40 (default 20).
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"page": 1,
"items": [
{
"id": "items_17650-120137222",
"upc": "00850221001627",
"url": "https://shop.sprouts.com/store/sprouts/products/120137222-grazeful-dairy-grassfed-whole-a2-a2-milk-2-gal",
"name": "Grazeful Dairy Whole Grassfed A2/A2 Milk",
"size": "64 oz",
"brand": "grazeful dairy",
"price": 3.79,
"badges": [
"New",
"Non-GMO"
],
"images": [
"https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_ad76b7ae-756e-4ef3-85e9-8023a0494681.png"
],
"rating": {
"count": 12,
"value": 4.9
},
"on_sale": true,
"category": "Plain Milk",
"currency": "USD",
"position": 1,
"product_id": "120137222",
"sale_price": 3.79,
"unit_price": {
"text": "$0.06/oz",
"unit": "oz",
"amount": 0.06
},
"availability": {
"in_stock": true,
"stock_level": "inStock"
},
"regular_price": 4.99,
"nutrition_highlights": [
{
"name": "Protein",
"unit": "g",
"value": 8
},
{
"name": "Sat Fat",
"unit": "g",
"value": 5
},
{
"name": "Sugar",
"unit": "g",
"value": 12
},
{
"name": "Sodium",
"unit": "mg",
"value": 105
},
{
"name": "Carbs",
"unit": "g",
"value": 12
},
{
"name": "Calories",
"value": 160
}
]
},
{
"id": "items_17650-120136748",
"upc": "00850221001610",
"url": "https://shop.sprouts.com/store/sprouts/products/120136748-grazeful-dairy-reduced-fat-grass-fed-a2-a2-milk-2-gal",
"name": "Grazeful Dairy Reduced Fat Grassfed A2/A2 Milk",
"size": "64 oz",
"brand": "grazeful dairy",
"price": 3.79,
"badges": [
"New",
"Non-GMO"
],
"images": [
"https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_902ab595-df91-4637-9765-68fdd1b010cb.png"
],
"rating": {
"count": 6,
"value": 4.7
},
"on_sale": true,
"category": "Plain Milk",
"currency": "USD",
"position": 2,
"product_id": "120136748",
"sale_price": 3.79,
"unit_price": {
"text": "$0.06/oz",
"unit": "oz",
"amount": 0.06
},
"availability": {
"in_stock": true,
"stock_level": "inStock"
},
"regular_price": 4.99,
"nutrition_highlights": [
{
"name": "Protein",
"unit": "g",
"value": 9
},
{
"name": "Sat Fat",
"unit": "g",
"value": 3
},
{
"name": "Sugar",
"unit": "g",
"value": 13
},
{
"name": "Sodium",
"unit": "mg",
"value": 135
},
{
"name": "Carbs",
"unit": "g",
"value": 13
},
{
"name": "Calories",
"value": 130
}
]
}
],
"query": "milk",
"per_page": 2,
"store_id": "393864",
"has_next_page": true,
"total_results": 253
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter or a value is invalid. This response is not billable.
{
"errors": {
"zip": [
"This ZIP code is not in the list of supported ZIP codes (85260, 90210, 77002, 30301, 80202). Use store_id for any other store."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Sprouts could not be reached after several tries. This response is not billable. Retry shortly.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Sprouts could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.