API Documentation

Base URL: https://api.seaotter.ai

All endpoints return JSON. No API key needed for public endpoints.

POST/api/v1/health-score/previewPublic

Compute a health score for any Shopify store from public data.

Request

{
  "store_url": "mystore.myshopify.com"
}

Response

{
  "overall_score": 74,
  "grade": "B",
  "sub_scores": {
    "inventory_health": 82,
    "catalog_size": 65,
    "listing_quality": 70,
    "freshness": 80,
    "catalog_diversity": 75
  },
  "insights": ["..."],
  "percentile": 62,
  "preview_metrics": {
    "product_count": 48,
    "in_stock_pct": 87.5,
    "avg_price": 42.50
  }
}

GET/api/v1/health-score/benchmarksPublic

Aggregate benchmark data from all scored stores.

Response

{
  "total_stores": 142,
  "avg_score": 68.3,
  "grade_distribution": {
    "A": 18, "B": 45, "C": 52, "D": 20, "F": 7
  },
  "unique_stores": 128
}

GET/api/v1/health-score/recentPublic

Recently scored stores (anonymized) for social proof.

Response

{
  "scores": [
    { "domain": "coastal", "score": 82, "grade": "A" },
    { "domain": "minimal", "score": 61, "grade": "C" }
  ],
  "total_scored": 142
}

POST/api/v1/waitlistPublic

Join the waitlist for early access.

Request

{
  "email": "you@example.com",
  "source": "landing"
}

Response

{
  "success": true,
  "message": "You're on the list!",
  "position": 47
}

GET/healthPublic

Service health check.

Response

{
  "status": "healthy",
  "service": "seaotter-api",
  "database": "ok"
}

Need the Enterprise API?

Benchmark data for investors, lenders, and platforms. Score any Shopify store programmatically.

Request early access