| Parameter (*=required) |
Possible values |
Default value |
Description |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| q |
[string] Sample: "woman -man" |
The keywords (or image-number) you like to
search for. Keywords to exclude begin with minus (-). Attention: All words after first minus are excluded! Example: "woman -man children" - includes "woman" - excludes "man" and "children" OR search is currently not supported |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| lang |
[string] single value
|
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
|
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. All preview URL's contain a watermark. If you need preview URL's without watermark e.g. to brand your own watermark, you need a special agreement. Please contact our sales team. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| filters | [string] multi value,
semicolan-separated
Sample: "sort: rel; orientation: horizontal; license: extended, spx;" |
Generally, you can only access media directly
from PantherMedia. Media from supplying third-party agencies
are not available for sub-distribution. If you are
implementing end user applications (e.g. mobile apps, games,
internal digital asset management systems for customers)
where you directly purchase and use the images, please contact
our sales team and ask for activation of additional
values in filter "contributor". Please note that requesting
external media results in higher resources and additional
performance, hence slower response times. To get all possible filter names and values dynamically please see the documentation of method get-search-filter. |
POST http://rest.panthermedia.net/search
Accept-Version: 1.2
Content-Type: application/x-www-form-urlencoded
api_key=a5e7b0dada779347e0fdd4db91ad883d0592aaca031e2c81234f3cb8008fdd1f&access_key=9de82c2a78df66e615274eec2622b53795abb2dd×tamp=Thu%2C%2002%20Aug%202012%2005%3A54%3A55%20UTC&nonce=123&algo=sha1&lang=en&q=woman&page=0&limit=10&extra_info=width,height,copyright,date,editorial,author_username,author_realname,model_id&filters=copyspace:small<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rsp stat="ok">
<items total="20020" items="10">
<media id="2606966"
thumb="http://agency.panthermedia.net/media/previews/0002000000/02606000/02606966_thumb_170.jpg"
width="4710px" height="3128px" copyright="(c) panthermedia.net /
Scott Griessel" date="Fri, 04 Dec 2009 21:56:54 UTC"
model-id="12135" author-username="Creatista"
author-realname="Scott Griessel"/>
<media id="2685506"
thumb="http://agency.panthermedia.net/media/previews/0002000000/02685000/02685506_thumb_170.jpg"
width="4181px" height="6272px" copyright="(c) panthermedia.net /
CandyBox Images" date="Fri, 22 Jan 2010 10:28:07 UTC"
model-id="28227" author-username="jmguyon"
author-realname="CandyBox Images"/>
<media id="2601148"
thumb="http://agency.panthermedia.net/media/previews/0002000000/02601000/02601148_thumb_170.jpg"
width="3744px" height="5616px" copyright="(c) panthermedia.net /
Erik Reis" date="Tue, 01 Dec 2009 20:41:19 UTC" model-id="14043"
author-username="iko" author-realname="Erik Reis"/>
<media id="1051069"
thumb="http://agency.panthermedia.net/media/previews/0001000000/01051000/01051069_thumb_170.jpg"
width="4096px" height="3504px" copyright="(c) panthermedia.net /
Yurok Aleksandrovich" date="Fri, 01 Feb 2008 23:00:00 UTC"
model-id="11315" author-username="yurok" author-realname="Yurok
Aleksandrovich"/>
<media id="1165395"
thumb="http://agency.panthermedia.net/media/previews/0001000000/01165000/01165395_thumb_170.jpg"
width="3072px" height="2048px" copyright="(c) panthermedia.net /
Tyler Olson" date="Tue, 01 Apr 2008 17:30:43 UTC" model-id="13799"
author-username="leaf" author-realname="Tyler Olson"/>
<media id="1409507"
thumb="http://agency.panthermedia.net/media/previews/0001000000/01409000/01409507_thumb_170.jpg"
width="4391px" height="3328px" copyright="(c) panthermedia.net /
Edward Bock" date="Mon, 04 Aug 2008 20:54:18 UTC"
model-id="17247,17249" author-username="edbockstock"
author-realname="Edward Bock"/>
<media id="1411749"
thumb="http://agency.panthermedia.net/media/previews/0001000000/01411000/01411749_thumb_170.jpg"
width="3888px" height="2592px" copyright="(c) panthermedia.net /
Philippe Ramakers" date="Tue, 05 Aug 2008 20:13:11 UTC"
model-id="2752" author-username="Intuitivmedia"
author-realname="Philippe Ramakers"/>
<media id="1413535"
thumb="http://agency.panthermedia.net/media/previews/0001000000/01413000/01413535_thumb_170.jpg"
width="2736px" height="4104px" copyright="(c) panthermedia.net /
Diego Cervo" date="Wed, 06 Aug 2008 15:48:11 UTC" model-id="11561"
author-username="diego.cervo" author-realname="Diego Cervo"/>
<media id="1415223"
thumb="http://agency.panthermedia.net/media/previews/0001000000/01415000/01415223_thumb_170.jpg"
width="2000px" height="3000px" copyright="(c) panthermedia.net /
Diego Cervo" date="Thu, 07 Aug 2008 14:11:41 UTC" model-id="13883"
author-username="diego.cervo" author-realname="Diego Cervo"/>
<media id="1987268"
thumb="http://agency.panthermedia.net/media/previews/0001000000/01987000/01987268_thumb_170.jpg"
width="4096px" height="6144px" copyright="(c) panthermedia.net /
Tyler Olson" date="Tue, 19 May 2009 15:31:29 UTC" model-id=""
author-username="leaf" author-realname="Tyler Olson"/>
</items>
</rsp>