What's the Score — B2B API

A physician-developed product health score for your nutrition app, retailer tooling, or research pipeline. Scan barcodes against 1.94M scored products, get back ingredient concerns, alternative recommendations, and a stable 0–100 score.

Pricing tiers

Authentication

Every request authenticates via an X-WTS-API-Key header. Keys are issued self-serve at the endpoint below. Each call is logged with per-key daily counts (rolls over at midnight UTC) and per-tier daily caps.

curl -H "X-WTS-API-Key: YOUR_KEY" \
  https://whatsthescore.app/api/v1/product/0028400315517

Endpoints

GET/api/v1/health

Unauthenticated liveness + stats. Returns total product count and the number of api_eligible products.

GET/api/v1/health/agents

Unauthenticated ops snapshot: last-run timestamps for the self-healer, search-quality, and image-quality agents plus counts for open alerts, unresolved missed scans, and pending feedback.

GET/api/v1/product/:barcode

Full product payload: score, grade, ingredients, concern additives, nutrition, is_ultra_processed, ingredient_count, sugar_grams, processing_level, score_headline, affiliate URLs, wine headache_factor + sugar_level when applicable.

curl -H "X-WTS-API-Key: YOUR_KEY" \
  https://whatsthescore.app/api/v1/product/0028400315517

GET/api/v1/product/search?name=&brand=&limit=

Intent-aware search. Keywords like beer, wine, shampoo, toothpaste, dog food are inferred to filter by category plus a word-boundary regex guard. Returns up to limit products (default 5, max 20) ranked by image presence, data quality, hit count, then score.

GET/api/v1/product/:barcode/alternative

If the scanned product scores below 60 and the scoring engine has tagged a better alternative, returns the alternative with a replaces block containing original_score, alternative_score, score_delta, percent_cleaner, and a human-readable headline string.

POST/api/v1/keys/create

Issue a new API key. Pass tier (starter, professional, enterprise) plus billing email. Stripe gate is in progress — for now keys are issued on application review.

curl -X POST https://whatsthescore.app/api/v1/keys/create \
  -H "Content-Type: application/json" \
  -d '{"email":"you@company.com","tier":"starter","name":"Your Company"}'

Response shape

{
  "product": {
    "barcode": "0028400315517",
    "name": "Cheetos Crunchy",
    "brand": "Frito-Lay",
    "category": "food",
    "wts_score": 32,
    "grade": "Poor",
    "score_headline": "Low score — contains Artificial colors (Red 40)",
    "concern_additives": [
      { "name": "Red 40", "severity": "high", "reason": "Azo dye — hyperactivity signal in children" }
    ],
    "ingredient_count": 18,
    "sugar_grams": 1,
    "processing_level": "ultra-processed",
    "is_ultra_processed": true,
    "has_amazon_url": true,
    "buy_url": "https://www.amazon.com/s?k=0028400315517&tag=whatsthesco0b-20",
    ...
  },
  "meta": {
    "cache_hit": true,
    "lookup_method": "barcode_lookup",
    "response_ms": 18,
    "api_version": "1.0"
  }
}

Rate limits & SLA

Tier	Daily cap	Burst	p95 latency
Starter	500	10 req/s	< 400 ms
Professional	5,000	50 req/s	< 300 ms
Enterprise	50,000	Negotiable	< 200 ms

Get in touch

Enterprise plans, white-label scoring, or a custom integration: email bryanwayneinc@gmail.com. We typically respond within 24 hours.