SocialCrawl

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.

cURL
curl "https://www.socialcrawl.dev/v1/sprouts/search?query=almond%20milk" \
  -H "x-api-key: YOUR_API_KEY"
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.

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

2 endpoints available.

EndpointPathCredit Tier
Get a Sprouts product by link/v1/sprouts/productstandard (1cr)
Search Sprouts products/v1/sprouts/searchstandard (1cr)

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

PathRows per pageDate windowOne call collects
/v1/sprouts/searchabout 24noneup 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