GET get_metadata

Given a list of image file paths, retrieve the associated metadata from the index.

Resource URL

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

Parameters

In addition to the Common parameters there are:

Key Description
filepaths[0] Metadata will be returned for this filepath.
... ...
filepaths[n] (optional) Metadata will be returned for this filepath.

Request example

curl https://multicolorengine.tineye.com/<company>/rest/get_metadata/ --get  \
     -d "filepaths[0]=path/folder/1.jpg"                                     \
     -d "filepaths[1]=path/folder/2.jpg"                                     \
     -d "filepaths[2]=path/folder/3.jpg"                                     \
     -d "filepaths[3]=path/folder/4.jpg"

Response example

JSON

{
    "status": "ok",
    "method": "get_metadata",
    "result": [
        {
            "filepath": "path/folder/1.jpg",
            "metadata": {
                "keywords": {
                    "action": "search",
                    "": [
                        "dog",
                        "cat",
                        "horse"
                    ],
                    "type": "string"
                }
            }
        },
        {
            "filepath": "path/folder/2.jpg",
            "metadata": {
                "keywords": {
                    "action": "search",
                    "": [
                        "lion",
                        "jaguar",
                        "cheetah"
                    ],
                    "type": "string"
                }
            }
        },
        {
            "filepath": "path/folder/3.jpg",
            "metadata": {
                "keywords": {
                    "action": "search",
                    "": [
                        "whale",
                        "shark",
                        "octopus"
                    ],
                    "type": "string"
                },
                "id": {
                    "action": "return",
                    "": "12345",
                    "type": "uint"
                }
            }
        },
        {
            "filepath": "path/folder/4.jpg",
            "metadata": {
                "keywords": {
                    "action": "search",
                    "": [
                        "dolphin",
                        "shark",
                        "whale"
                    ],
                    "type": "string"
                },
                "id": {
                    "action": "return",
                    "": "67890",
                    "type": "uint"
                }
            }
        }
    ],
    "error": []
}

XML

<?xml version="1.0" encoding="utf-8"?>
<data>
    <error/>
    <method>get_metadata</method>
    <result>
        <item>
            <filepath>path/folder/1.jpg</filepath>
            <metadata>
                <keywords action="search" type="string">
                    <dog/>
                    <cat/>
                    <horse/>
                </keywords>
            </metadata>
        </item>
        <item>
            <filepath>path/folder/2.jpg</filepath>
            <metadata>
                <keywords action="search" type="string">
                    <lion/>
                    <jaguar/>
                    <cheetah/>
                </keywords>
            </metadata>
        </item>
        <item>
            <filepath>path/folder/3.jpg</filepath>
            <metadata>
                <keywords action="search" type="string">
                    <whale/>
                    <shark/>
                    <octopus/>
                </keywords>
                <id action="return" type="uint">12345</id>
            </metadata>
        </item>
        <item>
            <filepath>path/folder/4.jpg</filepath>
            <metadata>
                <keywords action="search" type="string">
                    <dolphin/>
                    <shark/>
                    <whale/>
                </keywords>
                <id action="return" type="uint">67890</id>
            </metadata>
        </item>
    </result>
    <status>ok</status>
</data>