Color Similarity Calculator API

Overview

To use Color Similarity Calculator, you need an API key. You can get one by creating a free account and visiting your dashboard.

GET Endpoint

https://api.apiverve.com/v1/colorsimilarity

Example

How to call the Color Similarity Calculator API in different programming languages.

curl -X GET \
  "https://api.apiverve.com/v1/colorsimilarity?color1=FF5733&color2=FF6B47" \
  -H "X-API-Key: your_api_key_here"

const response = await fetch('https://api.apiverve.com/v1/colorsimilarity?color1=FF5733&color2=FF6B47', {
  method: 'GET',
  headers: {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

import requests

headers = {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.apiverve.com/v1/colorsimilarity?color1=FF5733&color2=FF6B47', headers=headers)

data = response.json()
print(data)

package main

import (
    "fmt"
    "io"
    "net/http"

)

func main() {
    req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/colorsimilarity?color1=FF5733&color2=FF6B47", nil)

    req.Header.Set("X-API-Key", "your_api_key_here")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

{
  "status": "ok",
  "error": null,
  "data": {
    "color1": {
      "hex": "#FF5733",
      "rgb": {
        "r": 255,
        "g": 87,
        "b": 51
      },
      "hsl": {
        "h": 10.6,
        "s": 100,
        "l": 60
      }
    },
    "color2": {
      "hex": "#FF6B47",
      "rgb": {
        "r": 255,
        "g": 107,
        "b": 71
      },
      "hsl": {
        "h": 11.7,
        "s": 100,
        "l": 63.9
      }
    },
    "rgb_distance": 28.28,
    "rgb_similarity": 93.6,
    "hsl_similarity": 97.71,
    "overall_similarity": 95.65,
    "delta_e": 28.28,
    "hue_difference": 1.15,
    "saturation_difference": 0,
    "lightness_difference": 3.92,
    "similarity_category": "nearly identical",
    "are_identical": false
  }
}

Authentication

The Color Similarity Calculator API requires authentication via API key. Include your API key in the request header:

X-API-Key: your_api_key_here

Learn more about authentication →

Interactive API Playground

Test the Color Similarity Calculator API directly in your browser with live requests and responses.

Parameters

The following parameters are available for the Color Similarity Calculator API:

Response

The Color Similarity Calculator API returns responses in JSON, XML, YAML, and CSV formats. The JSON response is shown in the Example section above; alternative formats below.

Other Response Formats

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ok</status>
  <error xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
  <data>
    <color1>
      <hex>#FF5733</hex>
      <rgb>
        <r>255</r>
        <g>87</g>
        <b>51</b>
      </rgb>
      <hsl>
        <h>10.6</h>
        <s>100</s>
        <l>60</l>
      </hsl>
    </color1>
    <color2>
      <hex>#FF6B47</hex>
      <rgb>
        <r>255</r>
        <g>107</g>
        <b>71</b>
      </rgb>
      <hsl>
        <h>11.7</h>
        <s>100</s>
        <l>63.9</l>
      </hsl>
    </color2>
    <rgb_distance>28.28</rgb_distance>
    <rgb_similarity>93.6</rgb_similarity>
    <hsl_similarity>97.71</hsl_similarity>
    <overall_similarity>95.65</overall_similarity>
    <delta_e>28.28</delta_e>
    <hue_difference>1.15</hue_difference>
    <saturation_difference>0</saturation_difference>
    <lightness_difference>3.92</lightness_difference>
    <similarity_category>nearly identical</similarity_category>
    <are_identical>false</are_identical>
  </data>
</response>

status: ok
error: null
data:
  color1:
    hex: '#FF5733'
    rgb:
      r: 255
      g: 87
      b: 51
    hsl:
      h: 10.6
      s: 100
      l: 60
  color2:
    hex: '#FF6B47'
    rgb:
      r: 255
      g: 107
      b: 71
    hsl:
      h: 11.7
      s: 100
      l: 63.9
  rgb_distance: 28.28
  rgb_similarity: 93.6
  hsl_similarity: 97.71
  overall_similarity: 95.65
  delta_e: 28.28
  hue_difference: 1.15
  saturation_difference: 0
  lightness_difference: 3.92
  similarity_category: nearly identical
  are_identical: false

Response Structure

All API responses follow a consistent structure with the following fields:

Learn more about response formats →

Response Data Fields

When the request is successful, the data object contains the following fields:

Headers

Only X-API-Key is required. Optional headers include Accept for response format negotiation (JSON, XML, or YAML), User-Agent, and X-Request-ID for request tracing. See all request headers →

GraphQL AccessALPHA

Access Color Similarity Calculator through GraphQL to combine it with other API calls in a single request. Query only the color similarity calculator data you need with precise field selection, and orchestrate complex data fetching workflows.

Credit Cost: Each API called in your GraphQL query consumes its standard credit cost.

POST https://api.apiverve.com/v1/graphql

query {
  colorsimilarity(
    input: {
      color1: "FF5733"
      color2: "FF6B47"
    }
  ) {
    color1 {
      hex
      rgb {
        r
        g
        b
      }
      hsl {
        h
        s
        l
      }
    }
    color2 {
      hex
      rgb {
        r
        g
        b
      }
      hsl {
        h
        s
        l
      }
    }
    rgb_distance
    rgb_similarity
    hsl_similarity
    overall_similarity
    delta_e
    hue_difference
    saturation_difference
    lightness_difference
    similarity_category
    are_identical
  }
}

Note: Authentication is handled via the x-api-key header in your GraphQL request, not as a query parameter.

CORS Support

The Color Similarity Calculator API accepts cross-origin requests from any origin, so it can be called directly from browser-based applications without a proxy. See CORS support →

Rate Limiting

Color Similarity Calculator requests are throttled per minute on the Free plan and unthrottled on paid plans. Exceeding the limit returns 429 Too Many Requests; rate-limit usage is reported in the X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset response headers. See per-plan limits and best practices →

Error Codes

The Color Similarity Calculator API uses standard HTTP status codes — 200 on success, 400 for invalid parameters, 401 for missing or invalid keys, 403 for insufficient credits, 429 for rate-limit exhaustion, and 500/503 for server-side issues. Each error response includes an X-Request-ID header you can quote when contacting support. See full error handling guide →

SDKs for Color Similarity Calculator

Official Color Similarity Calculator packages on npm, PyPI, NuGet, and JitPack — plus a Postman collection and an OpenAPI spec. See the SDK guide →

JitPack

No-Code Integrations

Color Similarity Calculator works with Zapier, Make, Pipedream, n8n, and Power Automate using the same API key. See setup guides →

Zapier

Make

Pipedream

n8n

Power Automate

Frequently Asked Questions

People who used this also used...

Based on your interest in Color Similarity Calculator, you might also like these APIs:

UTM Coordinate Converter

UTM Coordinate Converter provides bidirectional conversion between UTM (Universal Transverse Mercator) coordinates and latitude/longitude using WGS84 datum.

1 credit per call

Truth Table Generator

Truth Table Generator creates complete truth tables for boolean expressions with support for AND, OR, NOT, XOR, NAND, and NOR operators.

1 credit per call

Tip Calculator

Tip Calculator is a tool for calculating tips and splitting bills among multiple people. It provides common tip percentage comparisons and per-person breakdowns.

1 credit per call