ApplianceAPI Developer Hub
Everything you need to integrate appliance data into your application. Quickstart, authentication, endpoints, and response examples.
Everything you need to integrate ApplianceAPI into your application. REST API, JSON responses, API key authentication. No SDK required.
REST + JSON
Standard REST API with JSON responses. No GraphQL, no SOAP, no SDK required.
API Key Auth
Simple Bearer token authentication. Get your key in 2 minutes.
Structured Responses
Every response includes typed fields, confidence scores, and cache metadata.
Comprehensive Coverage
Photos, specs, dimensions, serial decoding, age estimation, model verification, recall checking.
Quickstart
- Sign up at /signup — free tier, no credit card
- Get your API key from the dashboard at /app/api-keys
- Make your first call:
curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://applianceapi.com/api/v1/images?brand=Whirlpool&model=WRS325SDHZ"
Authentication
All API requests require a Bearer token in the Authorization header:
Authorization: Bearer YOUR_API_KEYRate limits depend on your plan:
- Free — 10 lookups/month
- Starter ($79/mo) — 1,000 lookups/month
- Growth ($199/mo) — 4,000 lookups/month
- Pro ($499/mo) — 10,000 lookups/month
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/images | Model lookup — photo, title, specs, confidence |
| POST | /appliance-date/decode | Serial number decode — manufacture date, age |
| GET | /api/v1/recall | Recall check — CPSC recall status |
See full documentation for request/response schemas and additional endpoints.
Supported Data Types
The API returns data across these categories:
- Model identification — brand, model, product title, appliance type
- Product images — CDN URLs, confidence scores
- Serial decoding — manufacture date, age, confidence
- Specifications — dimensions, capacity, features
- Recall status — CPSC cross-reference
- Documentation links — manuals, spec sheets (coming soon)
All responses are typed JSON with consistent field naming across brands.
First API Call
{
"success": true,
"brand": "Whirlpool",
"model": "WRS325SDHZ",
"imageUrl": "https://applianceapi.com/assets/whirlpool/WRS325SDHZ.jpg",
"confidence": "high",
"title": "Whirlpool 25 Cu. Ft. Side-by-Side Refrigerator",
"cached": true,
"responseTime": "12ms"
}Frequently Asked Questions
What format are API responses in?
JSON. Every endpoint returns structured JSON with consistent field naming.
Is there a rate limit?
Yes. Free tier: 10/month. Starter: 1,000/month. Growth: 4,000/month. Pro: 10,000/month.
Do I need an SDK?
No. Standard HTTP requests with JSON responses. Use any language or framework.
What happens if a model is not found?
The API returns a 404 with queued: true, meaning it has been added to the enrichment queue.