Pixmac API

Gain access

1. Register at Pixmac.
2. Send email to api@pixmac.com, include your nickname on Pixmac. Also include your prefered response format(csv, xml, json) and chosen api method(downloading metadata or using pixmac search)
3. Wait for reply, we’ll add you to our system, generate api key for you and give you some free credits for testing.

Use API

Download metadata and thumbnails

• Download initial package of metadata and import them in your database
• Download or use our thumbnails
• Create your own search, listing or whatever way to display pictures you like
• Use API for downloading high resolution pictures
• You'll recieve access information to metadata and how to get thumbnails via email

sample metadata

    id;filename;title;description;keywords;userId
    000000000006;"brunette-girl-in-shopping-centre";"Brunette Girl in Shopping Centre, Shopping";"";",shopping, stores, shops, shopping centres, malls, shopping malls, lifestyle, indoors, interiors, people, person, humans, woman, women, females, feminine, femininity, 20-25 years, adult, 18 years+, young, young-adult, youth, 20s, portrait, half-length portrait, brunettes, short-haired, shirts, trendy, stylish, pretty, attractive, fashion, fed up, fed-up, lonely, lonesome, railings, gaze, gazing, hang about, hanging about, bored, slim, slender, skirts, one, one person, 1 person, teenagers, teenage, teens, adolescence, girls, sad, mournful, sorrowful,";27
    000000000042;"young-couple-shopping-10";"Young Couple Shopping";"";"shopping, stores, shops, shopping centres, malls, shopping malls, lifestyle, indoors, interiors, people, person, humans, two, two people, 2 people, couple, males, man, men, masculine, woman, women, females, feminine, femininity, 20-25, 25-30 years, adult, 18 years+, young, young-adult, youth, 20s, human relationships, human relations, relationships, love, partnership, togetherness, portrait, half-length portrait, happy, happiness, smile, smiling, bags, trendy, stylish, objects, brunettes, good-humoured, eye contact, escalators, joyful, cheerful,,";27
    000000000049;"young-woman-shopping-5";"Young Woman Shopping";"";"shopping, stores, shops, shopping centres, malls, shopping malls, lifestyle, indoors, interiors, people, person, humans, woman, women, females, feminine, femininity, 20-25 years, adult, 18 years+, young, young-adult, youth, 20s, portrait, full-length portrait, brunettes, short-haired, trendy, stylish, pretty, attractive, fashion, slim, slender, one, one person, 1 person, bags, handbags, hand-bags, flowers, escalators, profile, smile, smiling, happy, happiness, cheerful, joyful,,";27
    000000000057;"young-couple-dating";"Young Couple Dating";"";",indoors, interiors, people, person, humans, two, two people, 2 people, couple, males, man, men, masculine, woman, women, females, feminine, femininity, 20-25, 25-30 years, adult, 18 years+, young, young-adult, youth, 20s, flowers, blooms, white tulips, tulips, bunch of flowers, bunches of flowers, bouquets, profile, brunettes, pretty, attractive, short-haired,human relationships,human relations,relationships,love,affection,passion,partnership,romance,tenderness,caring,togetherness,portrait,half-length portrait,pleasure, in love,single object, dates, dating, rendezvous, appointment,";27
    000000000099;"000000000099";"Portrait of a Baby";"";"astonished, astonishment, wondering, surprised, open-mouthed, stunned, baby girl, amazed, big-eyed,family,families,indoors,interiors,people,person,humans,one,one person,1 person,child,children,childhood,kids,young,youth,baby,toddlers,babies,infant,infancy,little,girls,portrait,half-length portrait,,";27

Use Pixmac search

• Use API for searching in photos
• Use API for getting details of picture
• Use Pixmac thumbnails for displaying results
• Use API for downloading high resolution images

API methods

Requests must be made as HTTP GET or POST requests to http://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

Every request must include your apikey

Purchase and download actions require also your login and password parameters

Response can be plain text, json or xml

Search

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

• Parameters

  • apikey - your apikey
  • 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 '+'
  • page - page of result
  • skip - number of pictures on one result page
  • minsize - minimal size of hires(1 - 7)
  • price - price of 0.1mpix picture in credits(0,1)
  • 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:6

  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