GET get_metadata

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

Resource URL

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

Notes

Each request accepts maximum 10 filepaths.

Parameters

In addition to the Common parameters there are:

Filepath

Key

Description

filepath

A filepath for which metadata will be returned.

Filepaths

Key

Description

filepaths[0]

The first filepath for which metadata will be returned.

filepaths[n] (optional)

The last filepath for which metadata will be returned.

Request example

curl https://mobileengine.tineye.com/<company>/rest/get_metadata/   \
     -d "filepath=path/folder/1.jpg"

or

curl https://mobileengine.tineye.com/<company>/rest/get_metadata/   \
     -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 examples

JSON

{
    "method": "get_metadata",
    "status": "ok",
    "error": [],
    "result": [
        {
            "filepath": "path/folder/1.jpg",
            "metadata": {
                "image_id": "dd8d-6dc8-bf3f"
            }
        },
        {
            "filepath": "path/folder/2.jpg",
            "metadata": {
                "image_id": "db9561-7cecb6"
            }
        },
        {
            "filepath": "path/folder/3.jpg",
            "metadata": {
                "image_id": "9658451257"
            }
        },
        {
            "filepath": "path/folder/4.jpg",
            "metadata": {
                "image_id": "8ae4 ce20 88b05f"
            }
        }
    ],
    "stats": {
        "time_get_metadata": 3.2,
        "time_total": 3.56
    }
}

XML

<?xml version="1.0" encoding="utf-8"?>
<data>
    <method>get_metadata</method>
    <status>ok</status>
    <error/>
    <result>
        <item>
            <filepath>path/folder/1.jpg</filepath>
            <metadata>
                <image_id>dd8d-6dc8-bf3f</image_id>
            </metadata>
        </item>
        <item>
            <filepath>path/folder/2.jpg</filepath>
            <metadata>
                <image_id>db9561-7cecb6</image_id>
            </metadata>
        </item>
        <item>
            <filepath>path/folder/3.jpg</filepath>
            <metadata>
                <image_id>9658451257</image_id>
            </metadata>
        </item>
        <item>
            <filepath>path/folder/4.jpg</filepath>
            <metadata>
                <image_id>8ae4 ce20 88b05f</image_id>
            </metadata>
        </item>
    </result>
    <stats>
        <time_get_metadata>3.2</time_get_metadata>
        <time_total>3.56</time_total>
    </stats>
</data>