POST update_metadata¶

Resource URL
Performance
Parameters
- Filepath
- Filepaths
Request example
Response examples
- JSON
- XML

Update the metadata for a list of images already present in your collection.

Resource URL ¶

https://matchengine.tineye.com/<company>/rest/update_metadata/

Performance ¶

The MatchEngine API can perform one add, update or delete request at a time. Any extra requests submitted will be queued up for processing as slots become available.

Each request accepts maximum 10 filepaths.

Note that an image’s metadata can be completely cleared by setting its image_id to ‘{}’ string.

Parameters ¶

Filepath ¶

Key	Description
filepath	A filepath under which the image file was added to the collection.
image_id	An ID under which the image file will be stored in the collection. Any string or integer can be used as image ID, up to 255 characters.

Filepaths ¶

Key	Description
filepaths[0]	A filepath under which the first image file was added to the collection.
image_ids[0]	An ID under which the first image file will be stored in the collection.
…	…
filepaths[n] (optional)	A filepath under which the last image file was added to the collection.
image_ids[n] (optional)	An ID under which the last image file will be stored in the collection.

Request example ¶

curl https://matchengine.tineye.com/<company>/rest/update_metadata/   \
     -F "filepath=path/folder/1.jpg"                                  \
     -F "image_id=dd8d-6dc8-bf3f"

curl https://matchengine.tineye.com/<company>/rest/update_metadata/   \
     -F "filepaths[0]=path/folder/1.jpg"                              \
     -F "image_ids[0]=6558512785"                                     \
     -F "filepaths[1]=path/folder/2.jpg"                              \
     -F "image_ids[1]=9658451257"

curl https://matchengine.tineye.com/<company>/rest/update_metadata/   \
     -F "filepath=path/folder/1.jpg"                                  \
     -F "image_id={}"

Response examples ¶

JSON ¶

{
    "method": "update_metadata",
    "status": "ok",
    "error": [],
    "result": [],
    "stats": {
        "time_update": 6.01,
        "time_total": 6.56
    }
}

XML ¶

<?xml version="1.0" encoding="utf-8"?>
<data>
    <method>update_metadata</method>
    <status>ok</status>
    <error/>
    <result/>
    <stats>
        <time_update>6.01</time_update>
        <time_total>6.56</time_total>
    </stats>
</data>