FLICKCURL(1)

NAME
flickcurl - call Flickr API

SYNOPSIS
flickcurl [-d DELAY] [-a FROB] [-h] [-v] [commands] ...

DESCRIPTION
flickcurl is a program that can call some of the Flickr APIs, plus help with authentication by turning mobile authentication method frobs into full auth_tokens with -a NNN-NNN-NNN and writing the ~/.flickcurl.conf file. Use flickcurl -h to get a list of the supported commands and their arguments.

OPTIONS
These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-a FROB, --auth FROB
    Authenticate with a FROB and write auth config.

-d DELAY, --delay DELAY
    Set delay between requests to DELAY milliseconds.

-h, --help
    Show summary of options and exit.

-v, --version
    Display the version of the program and exit.

-V, --verbose
    Display more information while the program runs.

COMMANDS

activity.userComments [PER-PAGE [PAGE]]
    Get photos commented on by the caller.

activity.userPhotos [TIMEFRAME [PER-PAGE [PAGE]]]
    Get recent activity on the caller's photos.

auth.checkToken TOKEN
    Get the credentials attached to an authentication TOKEN.

auth.getFrob
    Get a frob to be used during authentication.

auth.getFullToken MINI-TOKEN
    Get the full authentication token for MINI-TOKEN.

auth.getToken TOKEN
    Get the auth token for the FROB, if one has been attached.

blogs.getList
    Get a list of configured blogs for the calling user.

blogs.postPhoto BLOG-ID PHOTO-ID TITLE DESCRIPTION [BLOG-PASSWORD]
    Post PHOTO-ID to blog BLOG-ID with TITLE, DESCRIPTION and optional password.

favorites.add PHOTO-ID
    Adds PHOTO-ID to the current user's favorites.

favorites.getList USER-NSID [[PER-PAGE] [PAGE]]
    Get a list of USER-NSID's favorite photos.

favorites.getPublicList USER-NSID [[PER-PAGE] [PAGE]]
    Get a list of USER-NSID's favorite public photos.

favorites.remove PHOTO-ID
    Removes PHOTO-ID to the current user's favorites.

groups.browse [CAT-ID]
    Browse groups below category CAT-ID (or root).

groups.getInfo GROUP-ID [LANG]
    Get information on group GROUP-ID with language LANG.

groups.pools.add PHOTO-ID GROUP-ID
    Add PHOTO-ID in GROUP-ID pool.

groups.pools.getContext PHOTO-ID GROUP-ID
    Get next and previous photos for PHOTO-ID in GROUP-ID pool.

groups.pools.getGroups [PAGE [PER-PAGE]]
    Get list of groups a user can add to.

groups.pools.getPhotos GROUP-ID [PAGE [PER-PAGE]]
    Get list of photos in GROUP-ID.

groups.pools.remove PHOTO-ID GROUP-ID
    Remove PHOTO-ID from group GROUP-ID.

groups.search TEXT [PER-PAGE [PAGE]]
    Search for groups matching TEXT paging PER-PAGE and PAGE.

interestingness.getList [PARAMS]
    Get interesting photos with optional parameters
    date DATE
    extras EXTRAS
    per-page PER-PAGE
    page PAGE

people.findByEmail EMAIL
    get a user's NSID from their EMAIL address

people.findByUsername USERNAME
    get a user's NSID from their USERNAME

people.getInfo USER-NSID
    Get information about one person with id USER-NSID

people.getPublicGroups USER-NSID
    Get list of public groups a user is amember of

people.getPublicPhotos USER-NSID [PER-PAGE [PAGE]]
    Get PAGE pages of PER-PAGE public photos for a user USER-NSID

people.getUploadStatus
    Get calling user upload status

photos.addTags PHOTO-ID TAGS
    Add TAGS to a PHOTO-ID.

photos.comments.addComment PHOTO-ID TEXT
    Add a photo comment TEXT to PHOTO-ID.

photos.comments.deleteComment COMMENT-ID
    Delete a photo comment COMMENT-ID.

photos.comments.editComment COMMENT-ID TEXT
    Edit a photo comment COMMENT-ID to have new TEXT.

photos.comments.getList PHOTO-ID
    Get the comments for a photo PHOTO-ID.

photos.delete PHOTO-ID
    Delete a PHOTO-ID.

photos.geo.getLocation PHOTO-ID
    Get the geo location for a photo PHOTO-ID.

photos.geo.getPerms PHOTO-ID
    Get the geo perms for a photo PHOTO-ID.

photos.geo.removeLocation PHOTO-ID
    Remove the location for a photo PHOTO-ID.

photos.geo.removeLocation PHOTO-ID LAT LONG ACCURACY
    Set the location for a photo PHOTO-ID.

photos.geo.setPerms PHOTO-ID IS-PUBLIC IS-CONTACT IS-FRIEND IS-FAMILY
    Set the geo perms for a photo PHOTO-ID.

photos.getAllContexts PHOTO-ID
    Get all visible sets and pools the PHOTO-ID belongs to.

photos.getContactsPhotos
    Get a list of recent photos from the calling users' contacts

photos.getContactsPublicPhotos USER-NSID
    Get a list of recent public photos from USER-NSID's contacts

photos.getContext PHOTO-ID
    Get next and previous photos for a PHOTO-ID in a photostream.

photos.getCounts DATES TAKEN-DATES
    Get the counts for a set of DATES or TAKEN-DATES.

photos.getExif PHOTO-ID
    Get EXIF information about one photo with id PHOTO-ID

photos.getFavorites PHOTO-ID [PER-PAGE [PAGE]]
    Get favourites information about one photo with id PHOTO-ID

photos.getInfo PHOTO-ID
    Get information about one photo with id PHOTO-ID

photos.getNotInSet [PER-PAGE [PAGE]]
    Get list of photos that are not in any set

photos.getPerms PHOTO-ID
    Get a photo viewing and commenting permissions

photos.getRecent [PER-PAGE [PAGE]]
    Get list of recent photos

photos.getSizes PHOTO-ID
    Get sizes of a PHOTO-ID

photos.getUntagged [PER-PAGE [PAGE]]
    Get list of photos that are not tagged

photos.getWithGeoData [PER-PAGE [PAGE]]
    Get list of photos that have geo data

photos.getWithoutGeoData [PER-PAGE [PAGE]]
    Get list of photos that do not have geo data

photos.licenses.getInfo
    Get list of available photo licenses

photos.licenses.setLicense PHOTO-ID LICENSE-ID
    Get photo PHOTO-ID license to LICENSE-ID

photos.notes.add PHOTO-ID X Y W H TEXT
    Add a note (X, Y, W, H, TEXT) to a photo with id PHOTO-ID

photos.notes.delete NOTE-ID
    Delete a note with id NOTE-ID

photos.notes.edit NOTE-ID X Y W H TEXT
    Edit note NOTE-ID to (X, Y, W, H, TEXT)

photos.recentlyUpdated [PER-PAGE [PAGE]]
    Get list of photos that were recently updated

photos.removeTag PHOTO-ID TAG-ID
    Remove a tag TAG-ID from a photo.

photos.search [PARAMS] tags TAGS...
    Search for photos/videos with many optional parameters
    user USER
    tag-mode any|all
    text TEXT
    (min|max)-(upload|taken)-date DATE
    license LICENSE
    privacy PRIVACY
    bbox a,b,c,d
    sort date-(posted|taken)-(asc|desc)|interestingness-(desc|asc)|relevance
    accuracy 1-16
    safe-search 1-3
    type 1-4
    machine-tags TAGS
    machine-tag-mode any|all
    group-id ID
    place-id ID
    extras EXTRAS
    per-page PER-PAGE
    page PAGES
    media all|photos|videos
    has-geo
    lat LAT lon LON radius RADIUS radius-units km|mi
    contacts (all|ff)

photos.setContentType PHOTO-ID TYPE
    Set photo TYPE to one of 'photo', 'screenshot' or 'other'

photos.setDates PHOTO-ID POSTED TAKEN GRANULARITY
    Set a photo POSTED date, TAKEN date with GRANULARITY

photos.setMeta PHOTO-ID TITLE DESCRIPTION
    Set a photo TITLE and DESCRIPTION

photos.setPerms PHOTO-ID IS-PUBLIC IS-FRIEND IS-FAMILY PERM-COMMENT PERM-ADDMETA
    Set a photo viewing and commenting permissions

photos.setSafetyLevel PHOTO-ID SAFETY-LEVEL HIDDEN
    Set a photo's SAFETY-LEVEL and HIDDEN flag

photos.setTags PHOTO-ID TAGS
    Set the tags for a PHOTO-ID to TAGS.

photos.transform.rotate PHOTO-ID DEGREES
    Rotate PHOTO-ID by 90/180/270 DEGREES

photos.upload.checkTickets TICKET-IDS...
    Get the status of upload TICKET-IDS

photosets.addPhoto PHOTOSET-ID PHOTO-ID
    Add PHOTO-ID to a PHOTOSET-ID.

photosets.comments.addComment PHOTOSET-ID TEXT
    Add a comment TEXT to photoset PHOTOSET-ID.

photosets.comments.deleteComment COMMENT-ID
    Delete a photoset comment COMMENT-ID.

photosets.comments.editComment COMMENT-ID TEXT
    Edit a photoset comment COMMENT-ID to have new TEXT.

photosets.comments.getList PHOTOSET-ID
    Get the comments for a photoset PHOTOSET-ID.

photosets.create TITLE DESCRIPTION PRIMARY-PHOTO-ID
    Create a photoset with TITLE, DESCRIPTION and PRIMARY-PHOTO-ID.

photosets.delete PHOTOSET-ID
    Delete a photoset with PHOTOSET-ID.

photosets.editMeta PHOTOSET-ID TITLE DESCRIPTION
    Set the TITLE and/or DESCRIPTION of a PHOTOSET-ID.

photosets.editPhotos PHOTOSET-ID PRIMARY-PHOTO-ID PHOTO-IDS...
    Set the PHOTO-IDs of a PHOTOSET-ID and PRIMARY-PHOTO-ID.

photosets.getContext PHOTO-ID PHOTOSET-ID
    Get next and previous photos for PHOTO-ID in PHOTOSET-ID.

photosets.getInfo PHOTOSET-ID
    Get information about PHOTOSET-ID.

photosets.getList [USER-NSID]
    Get the list of photosets for the USER-NSID.

photosets.getPhotos PHOTOSET-ID [EXTRAS [PRIVACY [PER-PAGE [PAGE]]]]
    Get the list of photos in PHOTOSET-ID with options.

photosets.orderSets PHOTOSET-IDS...
    Set the order of sets PHOTOSET-IDS.

photosets.removePhoto PHOTOSET-ID PHOTO-ID
    Remove PHOTO-ID from PHOTOSET-ID.

places.find TEXT
    Find places by TEXT query.

places.findByLatLon LAT LON ACCURACY
    Find places by LAT and LON with ACCURACY 1-16.

places.resolvePlaceId PLACE-ID  / WOE-ID
    Find places information by PLACE-ID or WOE-ID (number).

places.resolvePlaceURL PLACE-URL
    Find places information by PLACE-URL.

prefs.getContentType
    Get default content type preference for user.

prefs.getGeoPerms
    Get default privacy level for geographic info for user.

prefs.getHidden
    Get default hidden preference for user.

prefs.getPrivacy
    Get default privacy preference for user.

prefs.getSafetyLevel
    Get default safety level for user.

reflection.getMethodInfo NAME
    Get information about an API method NAME

reflection.getMethods
    Get API methods

replace FILE PHOTO-ID [async]
    Replace a photo PHOTO-ID with a new FILE (async)

tags.getClusters TAG
    Get list of tag clusters for TAG

tags.getHotList [PERIOD [COUNT]]
    Get the list of hot tags for the given PERIOD (day, week)

tags.getListPhoto PHOTO-ID
    Get the tag list for a PHOTO-ID.

tags.getListUser [USER-NSID]
    Get the tag list for a USER-NSID (or current user).

tags.getListUserPopular [USER-NSID [COUNT]]
    Get the popular tag list for a USER-NSID (or current user).

tags.getListUserRaw [TAG]
    Get the raw versions of a TAG (or all tags) for the current user.

tags.getRelated TAG
    Get a list of tags 'related' to TAG based on clustered usage analysis.

test.echo KEY VALUE
    Test echo API call; echos KEY VALUE

test.login
    Test login API call: returns username

test.null KEY VALUE
    Test null API call: no return

upload FILE [PARAMS...]
    Upload a photo FILE with optional parameters PARAM or PARAM VALUE
    title TITLE
    description DESC
    tags TAGS...
    friend
    public
    family

urls.getGroup GROUP-ID
    Get the url of the group page for GROUP-ID.

urls.getUserPhotos USER-NSID
    Get the url of the photo page for USER-NSID.

urls.getUserProfile USER-NSID
    Get the url of the profile page for USER-NSID.

urls.lookupGroup URL
    Get a group NSID from the URL to a group's page or photo pool.

urls.lookupUser URL
    Get a user NSID from the URL to a user's photo

SEE ALSO
flickrdf(1).

AUTHOR
flickcurl was written by David Beckett.

This manual page was written by Kumar Appaiah <akumar@ee.iitm.ac.in>, for the Debian project (but may be used by others).