# Sprouts (/docs/sprouts) Search Sprouts Farmers Market groceries with prices, sale prices and ratings, then read one product Sprouts Farmers Market sells natural and organic groceries. These endpoints search one Sprouts store's products by keyword and read one product: its price in US dollars, the regular price when it is on sale, stock, the star rating with its review count, the UPC and the pack size. Every result uses the canonical `Product` shape, and the Sprouts-only facts sit in `product.ext.sprouts`. Base URL: `/v1/sprouts/...` Sprouts exposes 2 routes here. ## Quickstart ### Search products Pass product keywords as `query`, and `store_id` for a particular store. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/sprouts/search?query=almond%20milk" \ -H "x-api-key: YOUR_API_KEY" ``` ```json title="Response (trimmed)" { "success": true, "data": { "items": [ { "product": { "id": "17786835", "title": "Elmhurst Unsweetened Milked Almonds", "price": { "current": 6.99, "original": 7.49, "currency": "USD" }, "rating": { "average": 4.4, "count": 28 }, "ext": { "sprouts": { "upc": "00018944001021", "size": "32 fl oz", "store_id": "177897" } } } } ] } } ``` ### Read one product Take `product.url` from a search row and pass it as `url`. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/sprouts/product?url=https%3A%2F%2Fshop.sprouts.com%2Fstore%2Fsprouts%2Fproducts%2F1377249-almond-breeze-unsweetened-original-almondmilk-96-fl-oz" \ -H "x-api-key: YOUR_API_KEY" ``` ## Questions people ask ### Which store are the prices from? `product.ext.sprouts.store_id` names the store on every row. Without `store_id` a default store answers; pass a store's id for its own catalog and prices. ### Where is the rating on a product? The product record carries no rating. The rating and review count are on the product's row in the search results. ## All endpoints **How far back and how deep** Each list returns one page at a time. Send `cursor` for the next page, or `max_items` or `max_pages` to collect several pages in one call. A page size appears only where it has been verified. [How paging works](/docs/pagination.md). | Path | Rows per page | Date window | One call collects | | --- | --- | --- | --- | | `/v1/sprouts/search` | about 24 | none | up to 5,000 rows or 50 pages | ## Platform notes **Pages can overlap.** Consecutive search pages can repeat a few products, so de-duplicate by `product.id` when you collect several pages. ## Next steps - [Kroger](/docs/kroger.md): Supermarket groceries in the same Product shape. - [Pagination](/docs/pagination.md): How list endpoints page.