[RESTful Web-service Documentation v1.0]
go top

search

returns media from the database, if you like to implement your own search algorithm (search-engine), please see also the method poll.

Parameter

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
  • da
  • de
  • en
  • es
  • it
  • pl
  • pt
en
language

see also get-user-content-langs for getting all language values dynamically
page [integer] 0

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.
filters [string] multi value, semicolan-separated
NameValuesDefault
  • sort
  • (sort order)
single value
  • rel (Relevance)
  • buy (Top-sellers)
  • date (Date)

buy
  • type
  • (media type)
single value
  • all (All files)
  • photos (Images)
  • illustrations (Illustrations)
  • vectors (Vectors)

all
  • license
multi value, comma-separated
  • commercial (Commercial)
  • editorial (Editorial)

commercial
  • collection
  • (to activate additional collection please contact us)
multi value, comma-separated
  • packet (packet)
  • subscription (subscription)
  • standard (standard)

packet, subscription, standard
  • contributor
  • (to activate additional contributor please contact us)
multi value, comma-separated
  • panther (PantherMedia)

panther
  • price
multi value, comma-separated
  • 1 (low price)
  • 2 (medium price)
  • 3 (high price)

1, 2, 3
  • size
  • (minimum size pixel)
single value
  • all (All)
  • 2480 (minimum 2480 pixel)
  • 3508 (minimum 3508 pixel)
  • 5600 (minimum 5600 pixel)

all
  • orientation
single value
  • all (All)
  • horizontal (Horizontal)
  • vertical (Vertical)
  • square (Square)
  • panorama (Panorama)

all
  • people_number
single value
  • all (All)
  • people_0 (No people)
  • people_any (With people)
  • people_1 (1 Person)
  • people_2 (2 People)
  • people_3 (3 People)
  • people_4 (4 People)
  • people_5 (5 People or more)

all
  • people_ethnicity
single value
  • all (All)
  • e (European / Caucasian)
  • xd (American)
  • a (Asian/Middle East)
  • f (African)
  • u (Australian/Oceanian)
  • b (Multi-ethnic)
  • x (Other)

all
  • people_age
single value
  • all (All)
  • babies (Babies)
  • children (Kids)
  • teenagers (Teenager)
  • adults (Adult)
  • seniors (Seniors)

all
  • people_gender
multi value, comma-separated
  • f (Female)
  • m (Male)

  • category
single value
  • -1 (All)
  • 1 (Animals)
  • 2 (Architecture)
  • 4 (Food)
  • 7 (Entertainment)
  • 5 (Graphics)
  • 8 (Lifestyle)
  • 9 (Nature)
  • 11 (People)
  • 3 (Business)
  • 14 (Symbols)
  • 12 (Society)
  • 13 (Sports)
  • 6 (Technology)
  • 15 (Transport)
  • 16 (Travel)
  • 10 (Objects)

-1
  • author
  • (author_username)
string

    • model
    • (model_id)
    string

      • color
      • (i.e. FFCC00)
      hexcode

        • color_tolerance
        single value
        • 2 (Exact (less results))
        • 5 (Standard)
        • 9 (Approx (more results))

        5
        • copyspace
        single value
        • all (All)
        • small (small copyspace)
        • medium (medium copyspace)
        • large (large copyspace)

        all
        • isolated
        • (isolated object)
        single value
        • isolated (Isolated object)

        • adult_content_filter
        • (filter erotic and violent content)
        single value
        • adult_content_filter (Hide erotic and violent content)

        • ranking
        • (quality)
        single value
        • all (All)
        • 6 (Good)
        • 8 (Very good)
        • 10 (Extremely good)

        all


        Sample: "sort: rel; orientation: horizontal; license: extended, rightsmanaged;"



        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.

        User-Authentication

        not required

        Endpoint

        http://rest.panthermedia.net/search

        Sample Request

        POST http://rest.panthermedia.net/search
        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&q=woman&page=0&limit=10&extra_info=width,height,copyright,date,editorial,author_username,author_realname,model_id&filters=copyspace:small

        Sample Answer

        <?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>