zooomr.photosets.create

Create a new photoset for the calling user.

Authentication

This method requires authentication with 'write' permission.

Note: This method requires an HTTP POST request.

Arguments

api_key (Required)

Your API application key.

title (Required)

A title for the photoset.

description (Required)

A description of the photoset. May contain limited html.

primary_photo_id (Required)

The id of the photo to represent this set. The photo must belong to the calling user.

rules (Required)

rules for how the photoset is created, each rule looks thus: <pre>rule_id | values_for_rule | rule_match_criteria \n</pre> So for views greater than 100 it would look like <pre>6|100|32</pre>

The rule_ids with associated match_criteria are:

  • PHOTOSETMATCH_PEOPLETAG = "0"
    • 0 is the only permissible match criteria
  • PHOTOSETMATCH_LABEL = "1"
    • MATCHALLOF = "2"
    • MATCHANYOF = "4"
    • MATCHNONEOF = "8"
  • PHOTOSETMATCH_DATEUPLOADED = "2" (unixtimestamp for date)
    • 0 is the only permissible match criteria
  • PHOTOSETMATCH_VIEWS = "6"
    • MATCHALLOF = "2"
    • MATCHANYOF = "4"
    • MATCHNONEOF = "8"
  • PHOTOSETMATCH_GEO = "7"
    • values as lat,long
    • match criteria is google maps zoomr level (3 is good)
  • PHOTOSETMATCH_DATETAKEN = "8" (unixtimestamp for date)
    • 0 is the only permissible match criteria

context (required)

  • PHOTOSFROM_YOU = "1"
  • PHOTOSFROM_YOURSOCIALCIRCLE = "2"
  • PHOTOSFROM_YOUANDYOURSOCIALCIRCLE = "3"
  • PHOTOSFROM_EVERYONE = "4"

sortmode (required)

  • SORTEDBY_AWESOMENESS = "2"
  • SORTEDBY_MOSTRECENT = "1"

Example Response

{"stat": "ok", "photoset": {"url": "http://zooomr.com/photos/bluemonki/sets/31913/", "id": 31913}}