Pixmac API

Pixmac offers an API for accessing Pixmac picture database. Currently we offer API functionality for two different usages:

  1. Affiliate partners

    Affiliate partners may register on this page and begin using the api immediately. Please note, that your API usage might be checked later for compliance with our service agreement.

  2. Resellers

    Resellers needs to contact Pixmac at email api@pixmac.com and make a signed contract with Pixmac company.

    Please note that minimum conditions for reselling Pixmac content are:

    • Minimum spending $3000 per month
    • Minimum prepayment $10,000 upfront

Gain access

  1. Register at Pixmac and log in to your account.
  2. Fill out form bellow for getting your personal API key.

You must register at Pixmac and log into your account. Then come back to this page and get your API key

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

Attendere per favore, la lightbox si sta caricando