Colors API
HerramientasMANTENIDA1 token / llamada

Colors API

Nombra, convierte y comprueba el contraste de cualquier color, con 31.919 nombres curados y cálculo WCAG

Todo lo que un producto hace con color, en una API. 31.919 nombres de colores curados por humanos (el proyecto MIT color-names, con su marca de calidad — el nombre mas cercano usa por defecto los 4.962 mejores nombres, asi #ff5733 vuelve como 'Orange Soda') mas todos los colores CSS con sus keywords de la especificacion. Convierte todo a todo: dale hex (#ff5733, corto #f53), rgb(255,87,51), '255,87,51' o hsl(11,100%,60%) y recibe hex, RGB, HSL, HSV, CMYK, luminancia relativa WCAG, marca claro/oscuro, el nombre curado mas cercano Y el keyword CSS mas cercano (tomato). Genera paletas con nombre — complementaria, analoga, triadica, tetradica, split-complementary, monocromatica, sombras, tintes — con el color base preservado exacto (sin deriva por redondeo HSL). Verifica accesibilidad WCAG: ratio de contraste con aprobado/reprobado AA/AAA para texto normal y grande (negro sobre blanco = 21). Busca entre 32k nombres ('sunset' → 74 colores), filtra al set curado o CSS, o pide uno al azar. Herramientas de diseno, constructores de temas, linters de accesibilidad, librerias de visualizacion, naming de swatches en e-commerce — un token por llamada.

Cada llamada necesita la cabecera X-Api-Key. Una clave gratuita incluye 500 tokens al mes, sin tarjeta. 1 token por llamada, así que el plan gratuito cubre unas 500 llamadas al mes.

Sin tarjeta de créditoAcceso a más de 125 APIsCancela cuando quieras
response.json
{
  "ok": true,
  "hex": "#ff5733",
  "rgb": {
    "r": 255,
    "g": 87,
    "b": 51
  },
  "hsl": {
    "h": 11,
    "s": 100,
    "l": 60
  },
  "hsv": {
    "h": 11,
    "s": 80,
    "v": 100
  },
  "cmyk": {
    "c": 0,
    "m": 65.88,
    "y": 80,
    "k": 0
  },
  "luminance": 0.283,
  "is_dark": false,
  "name": {
    "hex": "#fa5b3d",
    "name": "Orange Soda",
    "is_bestof": true,
    "is_css": false,
    "distance": 11.87,
    "exact": false
  },
  "nearest_css": {
    "hex": "#ff6347",
    "name": "tomato",
    "distance": 23.32
  }
}
Listo para producción
Infraestructura probada en producción con un SLA de disponibilidad del 99,9 %. Límites de uso generosos y respuestas consistentes.
Integración sencilla
REST + JSON estándar. Funciona con cualquier cliente HTTP. Fragmentos de código listos para copiar en 4 lenguajes.
Una clave, más de 125 APIs
Tu suscripción a DataAndAPIs desbloquea todas las APIs de la plataforma: anime, finanzas, deportes y más.

Casos de uso de Colors API

  • Etiquetar un color elegido por el usuario con un nombre humano en una herramienta de diseño, editor de temas o configurador de producto.

  • Convertir entre hex, RGB, HSL, HSV y CMYK en una llamada para exportación, impresión y generación de CSS.

  • Comprobar pares de texto y fondo contra los umbrales AA y AAA de WCAG en un linter de accesibilidad o un sistema de diseño.

  • Generar paletas complementarias, análogas, triádicas y de tintes y sombras a partir de un color de marca.

Endpoints de Colors API

Todos los endpoints con sus parámetros y una respuesta de ejemplo real.

GETConvert Color

https://api-colors.dataandapis.com/v1/colors/convert

Parámetros de consulta

ParámetroEjemplo
value#FF5733Obligatorio

Petición de ejemplo

curl "https://api-colors.dataandapis.com/v1/colors/convert?value=%23FF5733" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "hex": "#ff5733",
  "rgb": {
    "r": 255,
    "g": 87,
    "b": 51
  },
  "hsl": {
    "h": 11,
    "s": 100,
    "l": 60
  },
  "hsv": {
    "h": 11,
    "s": 80,
    "v": 100
  },
  "cmyk": {
    "c": 0,
    "m": 65.88,
    "y": 80,
    "k": 0
  },
  "luminance": 0.283,
  "is_dark": false,
  "name": {
    "hex": "#fa5b3d",
…
Ver la respuesta completa
{
  "ok": true,
  "hex": "#ff5733",
  "rgb": {
    "r": 255,
    "g": 87,
    "b": 51
  },
  "hsl": {
    "h": 11,
    "s": 100,
    "l": 60
  },
  "hsv": {
    "h": 11,
    "s": 80,
    "v": 100
  },
  "cmyk": {
    "c": 0,
    "m": 65.88,
    "y": 80,
    "k": 0
  },
  "luminance": 0.283,
  "is_dark": false,
  "name": {
    "hex": "#fa5b3d",
    "name": "Orange Soda",
    "is_bestof": true,
    "is_css": false,
    "distance": 11.87,
    "exact": false
  },
  "nearest_css": {
    "hex": "#ff6347",
    "name": "tomato",
    "distance": 23.32
  }
}

GETData Sources

https://api-colors.dataandapis.com/v1/sources

Este endpoint no recibe parámetros.

Petición de ejemplo

curl "https://api-colors.dataandapis.com/v1/sources" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "sources": [
    {
      "slug": "color-names",
      "name": "meodai color-names",
      "publisher": "meodai and contributors",
      "licence": "MIT",
      "source_url": "https://github.com/meodai/color-names",
      "file_url": "https://raw.githubusercontent.com/meodai/color-names/main/src/colornames.csv",
      "cadence": "community-updated; occasional re-scrape",
      "record_count": 31916,
      "retrieved_at": "2026-09-06"
    },
    {
      "slug": "css-colors",
      "name": "CSS named colors",
      "publisher": "W3C CSS Color Module",
      "licence": "W3C spec constants",
      "source_url": "https://www.w3.org/TR/css-color-4/#named-colors",
      "file_url": null,
      "cadence": "static",
      "record_count": 139,
      "retrieved_at": "2026-09-06"
    }
  ]
}

GETGenerate Palette

https://api-colors.dataandapis.com/v1/colors/palette

Parámetros de consulta

ParámetroEjemplo
count5Opcional
modetriadicOpcional
value1e90ffObligatorio

Petición de ejemplo

curl "https://api-colors.dataandapis.com/v1/colors/palette?count=5&mode=triadic&value=1e90ff" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "base": "#1e90ff",
  "mode": "triadic",
  "palette": [
    {
      "hex": "#1e90ff",
      "hsl": {
        "h": 210,
        "s": 100,
        "l": 55.88
      },
      "name": "Pool Water"
    },
    {
      "hex": "#ff1e8e",
      "hsl": {
        "h": 330,
        "s": 100,
        "l": 55.88
      },
      "name": "Fluorescent Pink"
    },
    {
      "hex": "#8eff1e",
      "hsl": {
        "h": 90,
        "s": 100,
…
Ver la respuesta completa
{
  "ok": true,
  "base": "#1e90ff",
  "mode": "triadic",
  "palette": [
    {
      "hex": "#1e90ff",
      "hsl": {
        "h": 210,
        "s": 100,
        "l": 55.88
      },
      "name": "Pool Water"
    },
    {
      "hex": "#ff1e8e",
      "hsl": {
        "h": 330,
        "s": 100,
        "l": 55.88
      },
      "name": "Fluorescent Pink"
    },
    {
      "hex": "#8eff1e",
      "hsl": {
        "h": 90,
        "s": 100,
        "l": 55.88
      },
      "name": "Loud Lime"
    }
  ]
}

GETName a Color

https://api-colors.dataandapis.com/v1/colors/name

Parámetros de consulta

ParámetroEjemplo
alltrueOpcional
count3Opcional
value40e0d0Obligatorio

Petición de ejemplo

curl "https://api-colors.dataandapis.com/v1/colors/name?all=true&count=3&value=40e0d0" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "query": "#40e0d0",
  "pool": "all 31,919 names",
  "matches": [
    {
      "hex": "#40e0d0",
      "name": "Fresh Turquoise",
      "is_bestof": false,
      "is_css": true,
      "distance": 0,
      "exact": true
    },
    {
      "hex": "#48d1cc",
      "name": "Medium Turquoise",
      "is_bestof": false,
      "is_css": true,
      "distance": 17.46,
      "exact": false
    },
    {
      "hex": "#45e9c1",
      "name": "Aphrodite Aqua",
      "is_bestof": true,
      "is_css": false,
      "distance": 18.19,
      "exact": false
…
Ver la respuesta completa
{
  "ok": true,
  "query": "#40e0d0",
  "pool": "all 31,919 names",
  "matches": [
    {
      "hex": "#40e0d0",
      "name": "Fresh Turquoise",
      "is_bestof": false,
      "is_css": true,
      "distance": 0,
      "exact": true
    },
    {
      "hex": "#48d1cc",
      "name": "Medium Turquoise",
      "is_bestof": false,
      "is_css": true,
      "distance": 17.46,
      "exact": false
    },
    {
      "hex": "#45e9c1",
      "name": "Aphrodite Aqua",
      "is_bestof": true,
      "is_css": false,
      "distance": 18.19,
      "exact": false
    }
  ]
}

GETRandom Color

https://api-colors.dataandapis.com/v1/colors/random

Parámetros de consulta

ParámetroEjemplo
bestoftrueOpcional

Petición de ejemplo

curl "https://api-colors.dataandapis.com/v1/colors/random?bestof=true" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "color": {
    "hex": "#c27f38",
    "name": "Ginger Beer",
    "is_bestof": true,
    "is_css": false,
    "rgb": {
      "r": 194,
      "g": 127,
      "b": 56
    },
    "hsl": {
      "h": 31,
      "s": 55.2,
      "l": 49.02
    },
    "hsv": {
      "h": 31,
      "s": 71.13,
      "v": 76.08
    },
    "cmyk": {
      "c": 0,
      "m": 34.54,
      "y": 71.13,
      "k": 23.92
    },
…
Ver la respuesta completa
{
  "ok": true,
  "color": {
    "hex": "#c27f38",
    "name": "Ginger Beer",
    "is_bestof": true,
    "is_css": false,
    "rgb": {
      "r": 194,
      "g": 127,
      "b": 56
    },
    "hsl": {
      "h": 31,
      "s": 55.2,
      "l": 49.02
    },
    "hsv": {
      "h": 31,
      "s": 71.13,
      "v": 76.08
    },
    "cmyk": {
      "c": 0,
      "m": 34.54,
      "y": 71.13,
      "k": 23.92
    },
    "luminance": 0.269,
    "is_dark": false
  }
}

GETSearch Colors

https://api-colors.dataandapis.com/v1/colors

Parámetros de consulta

ParámetroEjemplo
bestoftrueOpcional
cssOpcional
qsunsetOpcional

Petición de ejemplo

curl "https://api-colors.dataandapis.com/v1/colors?bestof=true&q=sunset" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "page": 1,
  "limit": 25,
  "total": 8,
  "total_pages": 1,
  "colors": [
    {
      "hex": "#dd8869",
      "name": "Canyon Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#eb9f9f",
      "name": "Cosy Summer Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#b52604",
      "name": "Crimson Velvet Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#f88517",
      "name": "Glorious Sunset",
…
Ver la respuesta completa
{
  "ok": true,
  "page": 1,
  "limit": 25,
  "total": 8,
  "total_pages": 1,
  "colors": [
    {
      "hex": "#dd8869",
      "name": "Canyon Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#eb9f9f",
      "name": "Cosy Summer Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#b52604",
      "name": "Crimson Velvet Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#f88517",
      "name": "Glorious Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#c38d87",
      "name": "Grand Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#e95e2a",
      "name": "Sunset Blaze",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#f6c362",
      "name": "Sunset Gold",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#fd5e53",
      "name": "Sunset Orange",
      "is_bestof": true,
      "is_css": false
    }
  ]
}

GETWCAG Contrast

https://api-colors.dataandapis.com/v1/colors/contrast

Parámetros de consulta

ParámetroEjemplo
bgffffffObligatorio
fg000000Obligatorio

Petición de ejemplo

curl "https://api-colors.dataandapis.com/v1/colors/contrast?bg=ffffff&fg=000000" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ok": true,
  "fg": "#000000",
  "bg": "#ffffff",
  "contrast_ratio": 21,
  "wcag": {
    "aa_normal_text": true,
    "aa_large_text": true,
    "aaa_normal_text": true,
    "aaa_large_text": true
  }
}

De dónde salen los datos

Fuente
El proyecto color-names (MIT, 31.919 nombres con un indicador de los mejores) y las palabras clave de la especificación CSS Color, con cálculo de contraste WCAG 2.
Actualización
Datos de referencia estáticos calculados en cada llamada. La lista de nombres se actualiza con cada versión.

Una instalación. Todos los endpoints.

No necesitas SDKs propietarios. Funciona con cualquier cliente HTTP. Elige tu lenguaje y pega el código.

3lenguajes
7endpoints
RESTarquitectura
1clave para todas las APIs
  • Respuestas totalmente tipadas — autocompletado en tu IDE
  • Sigue la API al día — los nuevos endpoints llegan el mismo día
  • Una sola clave funciona en más de 125 APIs de la plataforma
import axios from 'axios';

const { data } = await axios.get(
  'https://api-colors.dataandapis.com/v1/colors/convert',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Colors API · X-Api-Key

Explora los endpoints

Explora los parámetros de solicitud e inspecciona ejemplos de respuesta en vivo.

Endpoints disponibles

Parámetros de la solicitud

URL de la API

Encabezados

X-Api-Key

Parámetros de consulta

value(Obligatorio)
import axios from 'axios';

const url = 'https://api-colors.dataandapis.com/v1/colors/convert';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});

Una suscripción. Todas las APIs.

Los tokens desbloquean esta API y más de 20 más en DataAndAPIs. Cambia de API cuando quieras.

GRATIS

$0/mes

500 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte comunitario
Comienza gratis
Más Popular

STARTER

$6.99/mes

25.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte por email
Suscribirse

PRO

$24.99/mes

100.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte por email prioritario
Suscribirse

ULTRA

$99.99/mes

1.000.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte prioritario
Suscribirse

¿Necesitas mayor volumen, infraestructura dedicada o un contrato personalizado? Habla con ventas →

Preguntas sobre Colors API

Lanza Colors API esta tarde.

500 tokens gratis. Sin tarjeta. Y más de 125 APIs más con la misma clave.