[RESTful Web-service Documentation]
go top


returns a list of media id's to get media items are added, changed or deleted since you 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 (*=required)
Possible values
Default value
type * [string] single value
  • new
  • changed
  • deleted

last_polling * [string] single value

  • date in UTC format
  • media id

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

offset [integer] 0

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


 not required



Sample Request

POST http://rest.panthermedia.net/poll
Accept-Version: 1.0
Content-Type: application/x-www-form-urlencoded

Sample Answer

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rsp stat="ok">
  <items type="new" total="137" items="20">
    <media id="78771"/>
    <media id="80696"/>
    <media id="115372"/>
    <media id="197346"/>
    <media id="197348"/>
    <media id="197350"/>
    <media id="197352"/>
    <media id="197355"/>
    <media id="197356"/>
    <media id="197357"/>
    <media id="197358"/>
    <media id="197359"/>
    <media id="197364"/>
    <media id="197367"/>
    <media id="197369"/>
    <media id="197370"/>
    <media id="197372"/>
    <media id="197373"/>
    <media id="197374"/>
    <media id="197377"/>