search-similar

Methods

System

set-user-media-metadata

returns similar media

Parameter

Parameter (*=required)	Possible values	Default value	Description
id_media *	[string] Sample: "2345"
lang	[string] single value da de en es it pl pt	en	language see also get-user-content-langs for getting all language values dynamically
page	[integer] 1-	1	allowed value greater than equal 1
limit	[integer] 1-100	40	allowed values are between 1 and 100
extra_info	[string] multi value, comma-separated preview preview_high width height copyright date keywords title description editorial extended packet subscription premium rights_managed mimetype model_id model_release property_release author_username author_realname adult_content Sample: "preview,width,height,mimetype"		To return a list of extra information for each returned item. The "mimetype" can returns personal, vendor or special trees like "image/vnd.panthermedia.jpeg". This would be returned, if the exact mime-type isn't known on search time, but required to display the thumb/preview. For more see the RFC 2048. "model_release" and "property_release" return an boolean (yes/no) to check a release exists or not. All non editorial medias representing persons should contain a model release. For editorial medias it is not necessary.

Parameter (*=required)

Possible values

Default value

Description

id_media *

[string]
Sample: "2345"

lang

[string] single value

language

see also get-user-content-langs for getting all language values dynamically

page

[integer] 1-

allowed value greater than equal 1

limit

[integer] 1-100

allowed values are between 1 and 100

extra_info

[string] multi value, comma-separated

preview
preview_high
width
height
copyright
date
keywords
title
description
editorial
extended
packet
subscription
premium
rights_managed
mimetype
model_id
model_release
property_release
author_username
author_realname
adult_content

Sample: "preview,width,height,mimetype"

To return a list of extra information for each returned item.

The "mimetype" can returns personal, vendor or special trees like "image/vnd.panthermedia.jpeg".
This would be returned, if the exact mime-type isn't known on search time, but required to display the thumb/preview. For more see the RFC 2048.

"model_release" and "property_release" return an boolean (yes/no) to check a release exists or not. All non editorial medias representing persons should contain a model release. For editorial medias it is not necessary.

User-Authentication

Endpoint

Sample Request

POST https://rest.panthermedia.net/search-similar
Accept-Version: 1.0
Content-Type: application/x-www-form-urlencoded
api_key=a5e7b0dada779347e0fdd4db91ad883d0592aaca031e2c81234f3cb8008fdd1f&access_key=9de82c2a78df66e615274eec2622b53795abb2dd&timestamp=Thu%2C%2002%20Aug%202012%2005%3A54%3A55%20UTC&nonce=123&algo=sha1&lang=en&id_media=24681002&page=1&limit=5&extra_info=width,height,copyright,title

Sample Answer

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rsp stat="ok">
   <items total="490" items="5">
      <media id="24680990" thumb="https://mh-1-stockagency.panthermedia.net/media/previews/0024000000/24680000/24680990_thumb_170.jpg" width="5617px" height="3668px" copyright="(c) panthermedia.net / Anna Omelchenko" title="Happy mother and daughter portrait"/>
      <media id="24680992" thumb="https://mh-2-stockagency.panthermedia.net/media/previews/0024000000/24680000/24680992_thumb_170.jpg" width="5617px" height="3668px" copyright="(c) panthermedia.net / Anna Omelchenko" title="Happy mother and daughter portrait"/>
      <media id="24680994" thumb="https://mh-1-stockagency.panthermedia.net/media/previews/0024000000/24680000/24680994_thumb_170.jpg" width="5425px" height="3668px" copyright="(c) panthermedia.net / Anna Omelchenko" title="Love of mother and daughter"/>
      <media id="24681000" thumb="https://mh-2-stockagency.panthermedia.net/media/previews/0024000000/24681000/24681000_thumb_170.jpg" width="5573px" height="3668px" copyright="(c) panthermedia.net / Anna Omelchenko" title="Mother with daughter in the orchard"/>
      <media id="24680998" thumb="https://mh-2-stockagency.panthermedia.net/media/previews/0024000000/24680000/24680998_thumb_170.jpg" width="2287px" height="3306px" copyright="(c) panthermedia.net / Anna Omelchenko" title="Mother with daughter in the orchard"/>
   </items>
</rsp>

Generally

System

Auth

Media

User (Generally)