By apicloud
Updated a year ago

ColorTag API Documentation

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. Check out visual demo here: The API can sort tags by relevance (detecting colors of objects on the image, 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.).

Learn more about this API
POSTTag Image File
GETTag Image URL
POSTTag Image File

Returns a JSON object that contains color tags for the uploaded image (visual demo:

Header Parameters
Required Parameters
REQUIREDImage you want to analyze as uploaded file. For supported image files and limitations please refer to the documentation:
Optional Parameters
OPTIONALThe palette used for color tag generation. Default is 'simple'. For supported palettes and colors please refer to the documentation:
OPTIONALDefines 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:
Code Snippet
Install SDK
Response ExampleSchema

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication