API Documentation

Get up and running in minutes.

Quick Start

GET /api/v1/images?brand=Whirlpool&model=WRS325SDHZ
Authorization: Bearer YOUR_API_KEY

Response

{
  "found": true,
  "model": "WRS325SDHZ",
  "brand": "Whirlpool",
  "imageUrl": "https://cdn.applianceapi.com/images/whirlpool/WRS325SDHZ/primary.jpg",
  "thumbnailUrl": "https://cdn.applianceapi.com/images/whirlpool/WRS325SDHZ/thumb.jpg",
  "confidence": "HIGH",
  "cached": true
}

Authentication

Pass your API key as a Bearer token in the Authorization header. Keys follow the format aapi_live_...

Confidence Levels

• HIGH — Photo confirmed to match the model number. Human-reviewed. Safe for production.
• MEDIUM — Likely match. Suitable for catalog display with monitoring.
• LOW — Possible match. Not served by default; requires admin promotion.

Model Not Found

When a model isn't in our database, we return a 404 with queued: true. The model is automatically added to our enrichment queue — coverage grows over time.

{
  "found": false,
  "queued": true,
  "model": "WTW5000DW",
  "brand": "Whirlpool"
}