ColorTag is a powerful API for color detection. Taking an image file (or URL) as input ColorTag produces a list of text labels and hex RGB values that can be then used as tags for a certain image or item. The API can sort tags by relevance (recognizing colors of objects on the pictures, e.g. a dress, a car, etc.) or simply by weight in the image. First mode is perfect for e-commerce applications, allowing to automatically tag items with colors by simply providing a photo or a thumbnail and build a color tag cloud, so users are able to search items by color (e.g. red). Weight sorting mode can be useful for photos, wallpapers or other images without well-defined objects on them to analyze the palette in general. Text color labels can be assigned with different precision (just basic colors, W3C-compatible colors, precise colors, etc.).

Use Cases

ColorTag API can perform color segmentation and histogram analysis to provide descriptive color statistics for an image. It can be useful color-processing utility in the following cases:

  • Tag items with the appropriate color derived from a photo or a thumbnail
  • Build color tag clouds to allow searching by color
  • Evaluate a picture and find dominant colors in it
  • Validate images (e.g. to filter images by determining their primary color or a set of specified colors)
  • Find exact color names (e.g. azure, crimson, khaki or indigo)
  • Determine image‚Äôs perceptually dominant color and find complementary colors using services like Adobe Kuler or Colour Lovers
  • Everything else you can come up with :)

Demo

Online demo is available at http://www.apicloud.me/apis/colortag/demo/

Feel free to test the API as much as you like!

Documentation

The most recent and complete API documentation is always available at http://www.apicloud.me/apis/colortag/docs/

Last 7 days, UTC

Average Latency
91ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time

Simple & Straightforward Pricing

Pay as you go. No long-term contracts.

Freemium

$0

additional fees may apply

Calls

500 / mo.

$0.0050 per extra

Subscribe

basic

$18.00

per month

Calls

20,000 / mo.

$0.0040 per extra

Subscribe

ultra

$250.00

per month

Calls

750,000 / mo.

$0.0020 per extra

Subscribe

Endpoints

HTTP 200 : Response POST/tag-file.json
JSON object that contains color tags for the image (visual demo: http://apicloud.me/apis/colortag/demo/)
						{
  "tags": [
    {
      "label": "Green",
      "color": "#6EA76B"
    },
    {
      "label": "Beige",
      "color": "#C5AD98"
    },
    {
      "label": "Red",
      "color": "#533E34"
    },
    {
      "label": "Brown",
      "color": "#937C66"
    },
    {
      "label": "Pink",
      "color": "#DFD4CE"
    }
  ]
}						
Tag Image File

Returns a JSON object that contains color tags for the uploaded image (visual demo: http://apicloud.me/apis/colortag/demo/)


Test console
Description
Parameter
binary

Image you want to analyze as uploaded file. For supported image files and limitations please refer to the documentation: http://apicloud.me/apis/colortag/docs

image

Required

string

The palette used for color tag generation. Default is 'simple'. For supported palettes and colors please refer to the documentation: http://apicloud.me/apis/colortag/docs
Example: simple

palette

Optional

string

Defines how to sort colors. There are 2 modes: relevance (default) and weight. 'relevance' is best for determining colors of an object, while 'weight' can be used to analyze the overall image colors. Default is 'relevance'. For more information please refer to the documentation: http://apicloud.me/apis/colortag/docs
Example: relevance

sort

Optional

  • string – Indicates invalid call parameters: (e.g. URL not found, invalid image type or size, etc.). For more information please refer to the documentation: http://apicloud.me/apis/colortag/docs

    HTTP 400
  • string – Indicates internal API error (like image processing failure). However this case is very rare and we monitor all the API logs to fix issues as soon as possible.

    HTTP 500
HTTP 200 : Response GET/tag-url.json
JSON object that contains color tags for the image (visual demo: http://apicloud.me/apis/colortag/demo/)
						{
  "tags": [
    {
      "label": "Green",
      "color": "#6EA76B"
    },
    {
      "label": "Beige",
      "color": "#C5AD98"
    },
    {
      "label": "Red",
      "color": "#533E34"
    },
    {
      "label": "Brown",
      "color": "#937C66"
    },
    {
      "label": "Pink",
      "color": "#DFD4CE"
    }
  ]
}						
Tag Image URL

Returns a JSON object that contains color tags for the image specified by URL (visual demo: http://apicloud.me/apis/colortag/demo/)


Test console
Description
Parameter
string

URL of the image you would like to analyze. For supported image files and limitations please refer to the documentation: http://apicloud.me/apis/colortag/docs
Example: http://apicloud.me/assets/colortag/image1.jpg

url

Required

string

The palette used for color tag generation (optional). For supported palettes and colors please refer to the documentation: http://apicloud.me/apis/colortag/docs
Example: simple

palette

Optional

string

Defines how to sort colors. There are 2 modes: relevance (default) and weight. 'relevance' is best for determining colors of an object, while 'weight' can be used to analyze the overall image colors. For more information please refer to the documentation: http://apicloud.me/apis/colortag/docs
Example: relevance

sort

Optional

  • string – Indicates invalid call parameters: (e.g. URL not found, invalid image type or size, etc.). For more information please refer to the documentation: http://apicloud.me/apis/colortag/docs

    HTTP 400
  • string – Indicates internal API error (like image processing failure). However this case is very rare and we monitor all the API logs to fix issues as soon as possible.

    HTTP 500

You must have an API key to test this API!


Mashape allows developers to find, consume, and distribute cloud APIs just like ColorTag.

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.