PaintDB API
Free REST API for accessing 51,000+ paint colors from 27 global brands. JSON responses, no authentication required for basic usage.
Base URL
https://paintdb.com/api/v1
Endpoints
GET
/api/v1/colorsSearch and filter paint colors.
Query Parameters
| Param | Type | Description |
|---|---|---|
| q | string | Search by name, code, hex, or family |
| brand | string | Filter by brand slug |
| family | string | Filter by color family |
| lrv_min | number | Minimum LRV value |
| lrv_max | number | Maximum LRV value |
| limit | number | Results per page (default 20, max 100) |
| offset | number | Pagination offset |
Example
GET /api/v1/colors?q=navy&brand=benjamin-moore&limit=5
{
"data": [
{
"id": "bm-hc-154",
"name": "Hale Navy",
"code": "HC-154",
"brand": { "slug": "benjamin-moore", "name": "Benjamin Moore" },
"hex": "#434C59",
"rgb": { "r": 67, "g": 76, "b": 89 },
"lrv": 8,
"undertone": "Cool Gray",
"family": "blue",
"url": "https://paintdb.com/colors/benjamin-moore/bm-hc-154-hale-navy"
}
],
"meta": { "total": 1, "limit": 5, "offset": 0 }
}GET
/api/v1/colors/:idGet full details for a single color including similar colors and cross-brand matches.
GET /api/v1/colors/bm-hc-154
GET
/api/v1/brandsList all paint brands with color counts.
GET
/api/v1/brands/:slugGet brand details with top colors.
GET
/api/v1/compare?colors=id1,id2Compare 2-6 colors side by side with Delta E calculations.
GET /api/v1/compare?colors=bm-hc-154,sw-6244
Need Help?
The API is free for personal and commercial use. For high-volume usage, please reach out to discuss rate limits.