Pixmac API

Gain access

1. Register at Pixmac.
2. Send email to api@pixmac.com(In English or Czech), include your nickname on Pixmac. Also include your prefered response format(xml, json).
3. Wait for reply, we’ll add you to our system, generate api key for you and give access to the free collection for testing purposes

API methods

Api details

• Requests must be made as HTTP GET or POST requests to http://www.pixmac.com/api/ (or via HTTPS https://www.pixmac.com/api/)
• Param-value pairs can be specified in url like param/value as in this example: http://www.pixmac.com/api/detail/id/3/apikey/yourapikey or you can use standard url key-value pairs like this example: http://www.pixmac.com/api/detail/?id=3&apikey=yourapikey
• Every request must include your apikey
• You can specify language, please ask in email, if your language is available. Example Czech language is specified as /language/cs_CZ or &language=cs_CZ. Language can be used for search and for result of search and image detail.
• Purchase and download actions require also your login and password parameters
• Response can be plain text, json or xml

Search method

• http://www.pixmac.com/api/search

• Parameters

  • apikey - your apikey
  • page - page of result
  • skip - number of pictures on one result page
  • searchText - keywords separated with '+' followed by ';' and advanced params
  • searchText can include: keywords, colors, description of people
  • advanced params are specified as param:value, if there are more values, then it is param:val1-val2-val3, more params are separated with '+'
    • minsize - minimal size of hires(1 - any size, 2 - 5 mpix, 3 - 10 mpix, 4 - 15 mpix)
    • price - price of 0.1 mpix picture in credits(0,1, 2, 3)
    • extended - specify 1 if you want only extended license pictures
    • modelrelease - specify 1 if you want only pictures with model release
    • aspectration - format of photo(1 - portrait, 2 - landscape, 3 - panorama, 4 - square)
    • imagetype - 1 for photos, 2 for illustrations, 3 for vectors
    • Example searchText: old+woman+cat;imagetype:1-2+minsize:4 -> http://www.pixmac.com/api/search/searchText/old+woman+cat;imagetype:1-2+minsize:4/apikey/yourapikey

  Result

  • image_id
  • title
  • thumbnail_path
  • preview_path
  • filesize
  • width
  • height
  • authorName
  • authorId
  • uploaded

Detail

• http://www.pixmac.com/api/detail

• Parameters

  • apikey - your apikey
  • id - image id

  Result

  • image_id
  • title
  • thumbnail_path
  • preview_path
  • filesize
  • width
  • height
  • authorName
  • authorId
  • keywords
  • model_release
  • property_release
  • exclusive
  • formats - id
  • formats - title
  • formats - width
  • formats - height
  • formats - price

Purchase

• http://www.pixmac.com/api/purchase

• Parameters

  • apikey - your apikey
  • id - image id
  • priceid - price id
  • login - login
  • password - password

  Result

  • downloadpass

Download

• http://www.pixmac.com/api/download

• Parameters

  • apikey - your apikey
  • download_pass
  • login - login
  • password - password

  Result

  • image

Example microsite

Example microsite using JSON API and PHP for download for free in zip format. Download