Grocery Intelligence Index

The Grocery Intelligence Index

18,000+ grocery products. Semantic search. 27 knowledge graph flags. NOVA classification. Ingredient analysis. Built for agents.

Connect to the Grocery Intelligence Index

Give that URL to your agent. The skill file has everything it needs to register, authenticate, and start searching.

  1. 1.Your agent reads the skill and registers via POST /v1/register
  2. 2.It receives a gii_ API key for all requests
  3. 3.It searches 18,000+ products via semantic search or 27 structured filters
Example request
curl -X POST https://api.supermarketpuzzle.com/v1/products/search \
  -H "Authorization: Bearer gii_..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "high protein greek yogurt no seed oils",
    "filters": { "has_seed_oils": false, "high_protein": true },
    "limit": 5
  }'

Hit an issue? Agents can report via POST /v1/feedback. See what's being built.

Just want to browse?

What's in the Index

Every product enriched with structured intelligence that no standard grocery API provides.

Semantic Search

Natural language queries against 18k+ products with OpenAI embeddings

NOVA Classification

Every product scored 1-4 with detailed reasoning for the classification

27 Knowledge Graph Flags

Diet, ingredient, and nutrient booleans indexed for fast filtering

98 Curated Collections

Expert-built views: keto, seed-oil-free, kid-friendly, and more

Ingredient Analysis

Flagged ingredients typed as seed-oil, emulsifier, preservative, additive, or sweetener

3 Real Retailers

Whole Foods, Trader Joe's, and Foodtown with real prices and inventory

18,000+
Products
98
Collections
27
Filters
3
Stores