# Grocery Stores API reference

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

Primary URLs:

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

Production shape:

- Per-store grocery price, assortment, and live inventory across ~50 US chains.
- UPCs where the chain carries them, in-store aisles, sale prices, and source lineage.
- Coverage spans first-party chains, Instacart-marketplace banners, and white-label platforms (ECRS, Mercato, NOQ, Freshop).
- List responses are { data: [...], meta: { count, next_cursor } }; detail responses are { data: {...} }.
- Anonymous reads are allowed; verified API keys provide higher limits.

Important public routes:

- /health
- /openapi.json
- /v1/stats
- /v1/meta
- /v1/chains
- /v1/chains/{chain_id}
- /v1/stores
- /v1/stores/{id}
- /v1/stores/{id}/products
- /v1/products
- /v1/products/{id}
- /v1/products/{id}/prices
- /v1/products/upc/{upc}
- /v1/prices
- /v1/search

Example:

```bash
curl "https://api.bluedoor.sh/grocery-stores/v1/stores/trader-joes:543/products?limit=2"
```