[RESTful Web-service Documentation]
go top

poll

Please use the newest version v1.1 Poll of this method. This version is deprecated.

returns a list of media id's to get media items are added, changed or deleted since your last polling (this is not available for partner media data. For partner media real-time search is required).

With the method get-media-info you can get then the meta-data for your own search algorithm (search-engine).

See the method download-image-preview to cache preview (thumb) files.

Parameter

Parameter (*=required)
Possible values
Default value
Description
type * [string] single value
  • new
  • changed
  • deleted


last_polling * [string] single value

  • date in UTC format
  • media id


for an initial import use the media id "1" with type "new" and save the current date for future polling.

The highest possible date for finding new, changed or deleted media is always a few days in the past. On the one hand to remove media with licensing problems from the list early, on the other hand to avoid overlaps between polling and index update.
offset [integer] 0
due technical limitation, you must increase the parameter "last_polling" after a offset of 10000 to get the next 10000 items

sample requests and response
limit [integer 1-1000] 100
allowed values are between 1 and 1000

User-Authentication

 not required

Endpoint

http://rest.panthermedia.net/poll

Sample Request

POST http://rest.panthermedia.net/poll
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&type=new&last_polling=Sun%2C%2001%20Jan%202006%2001%3A01%3A00%20UTC

Sample Answer

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rsp stat="ok">
  <items type="new" total="137" items="20">
    <media id="78771" date="Mon, 02 Nov 2020 08:55:51 UTC"/>
    <media id="80696" date="Mon, 02 Nov 2020 09:06:06 UTC"/>
    <media id="115372" date="Mon, 02 Nov 2020 09:07:35 UTC"/>
    <media id="197346" date="Mon, 02 Nov 2020 09:08:53 UTC"/>
    <media id="197348" date="Mon, 02 Nov 2020 09:11:19 UTC"/>
    <media id="197350" date="Mon, 02 Nov 2020 09:11:19 UTC"/>
    <media id="197352" date="Mon, 02 Nov 2020 09:12:35 UTC"/>
    <media id="197355" date="Mon, 02 Nov 2020 09:15:22 UTC"/>
    <media id="197356" date="Mon, 02 Nov 2020 09:16:04 UTC"/>
    <media id="197357" date="Mon, 02 Nov 2020 09:17:58 UTC"/>
    <media id="197358" date="Mon, 02 Nov 2020 10:10:09 UTC"/>
    <media id="197359" date="Mon, 02 Nov 2020 10:25:38 UTC"/>
    <media id="197364" date="Mon, 02 Nov 2020 10:26:14 UTC"/>
    <media id="197367" date="Mon, 02 Nov 2020 10:34:51 UTC"/>
    <media id="197369" date="Mon, 02 Nov 2020 10:39:32 UTC"/>
    <media id="197370" date="Mon, 02 Nov 2020 10:41:09 UTC"/>
    <media id="197372" date="Mon, 02 Nov 2020 10:48:47 UTC"/>
    <media id="197373" date="Mon, 02 Nov 2020 10:48:48 UTC"/>
    <media id="197374" date="Mon, 02 Nov 2020 11:22:11 UTC"/>
    <media id="197377" date="Mon, 02 Nov 2020 12:05:36 UTC"/>
  </items>
</rsp>
Sample offset over 10000

Request last offset

POST http://rest.panthermedia.net/poll
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&type=new&last_polling=1&limit=100&offset=9900

Answer last offset

<rsp stat="ok">
  <items type="new" total="3664487" items="100">
    ....
    <media id="12864470" date="Mon, 17 Nov 2014 07:06:10 UTC"/>
  </items>
</rsp>

Request next offset

Use the last date as "last_polling" and "offset" with 0 to get the next 10000 items.

POST http://rest.panthermedia.net/poll
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&type=new&last_polling=Mon%2C%2017%20Nov%202014%2007%3A06%3A10%20UTC&limit=100&offset=0

Answer next offset

<rsp stat="ok">
  <items type="new" total="3654488" items="100">
    <media id="12864470" date="Mon, 17 Nov 2014 07:06:10 UTC"/>
    ....
  </items>
</rsp>