GET count_metadata

Given an entire image collection or given a subset of the collection filtered using metadata and/or a list of colours and/or a list of collection images, and given a list of metadata queries, generate a counter for each query specifying how many of the collection images meet that query.

Resource URL

https://multicolorengine.tineye.com/<company>/rest/count_metadata/

Parameters

In addition to the Common parameters there are:

Collection

Key Description
count_metadata[0] A metadata query which you want to count.
... ...
count_metadata[n] (optional) A metadata query which you want to count.

Metadata

Key Description
metadata The metadata query to be used for image filtering.
count_metadata[0] A metadata query which you want to count.
... ...
count_metadata[n] (optional) A metadata query which you want to count.
min_score (optional) Minimum score to filter the queries by.

Colors

Key Description
colors[0] A color to be used for image filtering. Can be entered as either RGB format (255,255,255) or hex format (ffffff).
... ...
colors[n] (optional) A color to be used for image filtering.
weights[0] (optional, but required for all colors if specified) A weight for the first color, should be between 1 and 100 and all weights should add up to 100.
... ...
weights[n] (optional) A weight for the nth color.
count_metadata[0] A metadata query which you want to count.
... ...
count_metadata[n] (optional) A metadata query which you want to count.
min_score (optional) Minimum score to filter the queries by.

Filepaths

Key Description
filepaths[0] An image file from the collection whose metadata will be counted.
... ...
filepaths[n] (optional) An image file from the collection whose metadata will be counted.
count_metadata[0] A metadata query which you want to count.
... ...
count_metadata[n] (optional) A metadata query which you want to count.

Request example

Collection

curl https://multicolorengine.tineye.com/<company>/rest/count_metadata/ --get                           \
     -F "count_metadata[0]='{\"keywords\": \"dog\"}'"                                                   \
     -F "count_metadata[1]='{\"_or_operator_\": [{\"keywords\": \"whale\"}, {\"keywords\": \"shark\"}]}'"

Metadata

curl https://multicolorengine.tineye.com/<company>/rest/count_metadata/ --get                    \
     -F "metadata='{\"_or_operator_\": [{\"keywords\": \"cat\"}, {\"keywords\": \"cheetah\"}]}'" \
     -F "count_metadata[0]='{\"keywords\": \"dog\"}'"                                            \
     -F "count_metadata[1]='{\"keywords\": \"whale\"}'"

Colors

curl https://multicolorengine.tineye.com/<company>/rest/count_metadata/ --get                                   \
     -F "colors[0]=255,112,223"                                                                                 \
     -F "colors[1]=95,136,165"                                                                                  \
     -F "weights[0]=70"                                                                                         \
     -F "weights[1]=30"                                                                                         \
     -F "count_metadata[0]='{\"_or_operator_\": [{\"keywords\": \"dolphin\"}, {\"keywords\": \"octopus\"}]}'"

Filepaths

curl https://multicolorengine.tineye.com/<company>/rest/count_metadata/ --get  \
     -F "filepaths[0]=path/folder/1.jpg"                                       \
     -F "filepaths[1]=path/folder/2.jpg"                                       \
     -F "count_metadata[0]='{\"keywords\": \"cat\"}'"

Response example

JSON

{
    "status": "ok",
    "error": [],
    "method": "count_metadata",
    "result": [
        {
            "metadata": [
                {
                    "count-metadata": {
                        "count": "1",
                        "": {
                            "keywords": "dog"
                        }
                    }
                },
                {
                    "count-metadata": {
                        "count": "4",
                        "": {
                            "_or_operator_": [
                                {
                                    "keywords": "whale"
                                },
                                {
                                    "keywords": "shark"
                                }
                            ]
                        }
                    }
                }
            ]
        }
    ]
}

XML

<?xml version="1.0" encoding="utf-8"?>
<data>
    <error/>
    <method>count_metadata</method>
    <result>
        <item>
            <metadata>
                <count-metadata count="1">
                    <keywords>dog</keywords>
                </count-metadata>
                <count-metadata count="4">
                    <_or_operator_>
                        <keywords>whale</keywords>
                        <keywords>shark</keywords>
                    </_or_operator_>
                </count-metadata>
            </metadata>
        </item>
    </result>
    <status>ok</status>
</data>