# Grocery Stores data surface

Use this as compact context for the bluedoor Grocery Stores API data pages.

Primary URLs:

- Data home: https://bluedoor.sh/data/grocery-stores
- API landing page: https://bluedoor.sh/apis/grocery-stores
- Docs: https://bluedoor.sh/apis/grocery-stores/docs
- OpenAPI JSON: https://bluedoor.sh/apis/grocery-stores/docs/openapi.json
- API base URL: https://api.bluedoor.sh/grocery-stores/v1

Access model:

- Anonymous reads are public and rate limited.
- Email-authenticated API keys use the standard bluedoor token bucket.
- ~50 US grocery banners are standardized across first-party, Instacart-marketplace, and white-label platforms.
- Per store: shelf price, UPC where carried, in-store aisle, sale prices, and live inventory.

Collections:

- Chains: Grocery retailer chains and banners with parent company, backend family, data quality (UPC, aisle, price kind, stock kind), store and product counts, and sync status. Route: /chains
- Stores: Individual grocery stores with chain, address, geocode, fulfillment options, and product counts, filterable by chain, state, city, postal code, and free-text query. Route: /stores
- Products: Catalog products with brand, size, category path, UPC, dietary tags, and images, filterable by chain, brand, category, and UPC. Route: /products
- Prices: Per-store price observations with regular and sale price, price-per-unit, in-stock and stock level, in-store aisle, store and product identity, and observation dates. Route: /prices
- Search: Cross-store product search by name, brand, size, or category, with store coverage counts and observed price ranges. Route: /search

Important pages:

- https://bluedoor.sh/data/grocery-stores/chains
- https://bluedoor.sh/data/grocery-stores/stores
- https://bluedoor.sh/data/grocery-stores/products
- https://bluedoor.sh/data/grocery-stores/prices
- https://bluedoor.sh/data/grocery-stores/search
- https://bluedoor.sh/data/grocery-stores/indexes

Crawl seeding:

- Sitemap: https://bluedoor.sh/data/grocery-stores/sitemap.xml
- Seeded URLs: 28
- Seed searches: milk, eggs, bananas, olive oil, greek yogurt, coffee