flickcurl(1)

1FLICKCURL(1)                General Commands Manual               FLICKCURL(1)
2
3
4

NAME

6       flickcurl - call Flickr API
7

SYNOPSIS

9       flickcurl -a FROB
10       flickcurl [-d DELAY] [-h] [-o FILE] [-q] [-v] [-V] [commands] ...
11

DESCRIPTION

13       flickcurl  is  a utility program to call the Flickr APIs via the flick‐
14       curl library.  Run flickcurl -h to get a list of the supported commands
15       and their arguments.
16
17       The  program  requires  configuring  before use to work with the Flickr
18       APIs.  Run flickcurl without any options to get  the  instructions  for
19       registering the application and creating the initial configuration file
20       ~/.flickcurl.conf from the registration information.
21

OPTIONS

23       These programs follow the usual GNU  command  line  syntax,  with  long
24       options  starting  with  two  dashes  (`-').   A  summary of options is
25       included below.
26
27       -a FROB, --auth FROB
28              Authenticate with a FROB and  update  the  authentication  file.
29              The program will exit after updating the file.
30
31       -d DELAY, --delay DELAY
32              Set delay between requests to DELAY milliseconds.
33
34       -h, --help
35              Show summary of options and exit.
36
37       -o FILE, --output FILE
38              Write the results of format feed API calls to FILE
39
40       -q, --quiet
41              Display less information while the program runs.
42
43       -v, --version
44              Display the version of the program and exit.
45
46       -V, --verbose
47              Display more information while the program runs.
48

COMMANDS

50       In the following list of commands:
51       PER-PAGE is photos per result page or '-' for default (10)
52       PAGE is result page number or '-' for default (1 = first page)
53
54       activity.userComments [PER-PAGE [PAGE]]
55              Get photos commented on by the caller.
56
57       activity.userPhotos [TIMEFRAME [PER-PAGE [PAGE]]]
58              Get recent activity on the caller's photos.
59
60       auth.checkToken TOKEN
61              Get the credentials attached to an authentication TOKEN.
62
63       auth.getFrob
64              Get a frob to be used during authentication.
65
66       auth.getFullToken MINI-TOKEN
67              Get the full authentication token for MINI-TOKEN.
68
69       auth.getToken TOKEN
70              Get the auth token for the FROB, if one has been attached.
71
72       blogs.getList
73              Get a list of configured blogs for the calling user.
74
75       blogs.getServices
76              Get a list of blog services.
77
78       blogs.postPhoto BLOG-ID PHOTO-ID TITLE DESCRIPTION [BLOG-PASSWORD]
79              Post  PHOTO-ID  to  blog  BLOG-ID  with  TITLE,  DESCRIPTION and
80              optional password.
81
82       collections.getInfo COLLECTION-ID
83              Get information on collection COLLECTION-ID
84
85       collections.getTree [COLLECTION-ID|- [USER-ID|-]]
86              Get tree of collections COLLECTION-ID for USER-ID
87
88       commons.getInstitutions
89              Get list of institutions
90
91       contacts.getList [FILTER [PER-PAGE [PAGE]]]
92              Get a list of contacts with optional FILTER
93
94       contacts.getListRecentlyUploaded [DATE-LAST-UPLOAD [FILTER]]
95              Get a list of recent uploading contacts  since  DATE-LAST-UPLOAD
96              with optional FILTER
97
98       contacts.getPublicList USER-NSID [PER-PAGE [PAGE]]
99              Get the contact list for user USER-NSID
100
101       contacts.getTaggingSuggestions  [PER_PAGE [PAGE [INCLUDE-SELF [INCLUDE-
102       ADDRESS-BOOK]]]]
103              Get tagging suggestions
104
105       favorites.add PHOTO-ID
106              Adds PHOTO-ID to the current user's favorites.
107
108       favorites.getContext PHOTO-ID USER-NSID [NUM-PREV [NUM-NEXT [EXTRAS]]]
109              Get context photos around USER-ID's favorite PHOTO-ID.
110
111       favorites.getList USER-NSID [PER-PAGE [PAGE [FORMAT]]]
112              Get a list of USER-NSID's favorite photos.
113
114       favorites.getPublicList USER-NSID [PER-PAGE [PAGE [FORMAT]]]
115              Get a list of USER-NSID's favorite public photos.
116
117       favorites.remove PHOTO-ID
118              Removes PHOTO-ID to the current user's favorites.
119
120       galleries.addPhoto GALLERY-ID PHOTO-ID TEXT
121              Add photo PHOTO-ID to galleries GALLERY-ID with TEXT
122
123       galleries.create TITLE [DESCRIPTION [PRIMARY-PHOTO-ID]
124              Create a  new  gallery  with  TITLE,  DESCRIPTION  and  PRIMARY-
125              PHOTO_ID.
126
127       galleries.editMeta GALLERY-ID TITLE [DESCRIPTION]
128              Set the TITLE and/or DESCRIPTION of a GALLERY-ID.
129
130       galleries.editPhoto GALLERY-ID PHOTO-ID COMMENT
131              Set the COMMENT for PHOTO-ID in GALLERY-ID.
132
133       galleries.editPhotos GALLERY-ID PRIMARY-PHOTO-ID PHOTO-IDS,...
134              Set the PHOTO-IDs of a GALLERY-ID and PRIMARY-PHOTO-ID.
135
136       galleries.getInfo GALLERY-ID
137              Get information about GALLERY-ID.
138
139       galleries.getList USER-ID [PER-PAGE [PAGE]]
140              Get list of galleries for a USER-ID with optional paging
141
142       galleries.getListForPhoto PHOTO-ID [PER-PAGE [PAGE]]
143              Get list of galleries PHOTO-ID appears in with optional paging
144
145       galleries.getPhotos GALLERY-ID [EXTRAS [PER-PAGE [PAGE [FORMAT]]]]
146              Get the list of photos in GALLERY-ID with options.
147
148       getphotoid IMAGE-URL
149              Get the photo id from a raw flickr farm IMAGE-URL
150
151       groups.browse [CAT-ID]
152              Browse groups below category CAT-ID (or root).
153
154       groups.getInfo GROUP-ID [LANG]
155              Get information on group GROUP-ID with language LANG.
156
157       groups.join GROUP-ID [ACCEPT-RULES]
158              Join a group GROUP-ID with optional accepting of rules.
159
160       groups.joinRequest GROUP-ID MESSAGE ACCEPT-RULES
161              Request to join a group GROUP-ID using MESSAGE and accept rules.
162
163       groups.leave GROUP-ID [DELETE-PHOTOS]
164              Leave a group GROUP-ID and optionally delete photos.
165
166       groups.members.getList GROUP-ID [MEMBER-TYPES [PER-PAGE [PAGE]]]
167              Get list of MEMBER-TYPES types members of group GROUP-ID.
168
169       groups.pools.add PHOTO-ID GROUP-ID
170              Add PHOTO-ID in GROUP-ID pool.
171
172       groups.pools.getContext PHOTO-ID GROUP-ID
173              Get next and previous photos for PHOTO-ID in GROUP-ID pool.
174
175       groups.pools.getGroups [PER-PAGE [PAGE]]
176              Get list of groups a user can add to.
177
178       groups.pools.getPhotos GROUP-ID [PER-PAGE [PAGE [FORMAT]]]
179              Get list of photos in GROUP-ID.
180
181       groups.pools.remove PHOTO-ID GROUP-ID
182              Remove PHOTO-ID from group GROUP-ID.
183
184       groups.search TEXT [PER-PAGE [PAGE]]
185              Search for groups matching TEXT paging PER-PAGE and PAGE.
186
187       interestingness.getList [PARAMS]
188              Get interesting photos with optional parameters
189              date DATE
190              extras EXTRAS
191              per-page PER-PAGE
192              page PAGE
193              format FORMAT
194
195       machinetags.getNamespaces [PREDICATE [PER-PAGE [PAGE]]]
196              Get a list of namespaces with optional PREDICATE
197
198       machinetags.getPairs [NAMESPACE [PREDICATE [PER-PAGE [PAGE]]]]
199              Get a list of unique NAMESPACE and PREDICATE pairs
200
201       machinetags.getPredicates [NAMESPACE [PER-PAGE [PAGE]]]
202              Get a list of unique predicates optionally by NAMESPACE
203
204       machinetags.getRecentValues [NAMESPACE|- [PREDICATE|- [ADDED-SINCE]]]
205              Get  a  list  of  recent machinetags for NAMESPACE and PREDICATE
206              since ADDED-SINCE
207
208       machinetags.getValues NAMESPACE PREDICATE [PER-PAGE [PAGE]]
209              Get a list of unique values for a NAMESPACE and PREDICATE
210
211       oauth.create [CALLBACK]
212              Create OAuth request token/secret pair and show the  authentica‐
213              tion URL
214
215       oauth.upgrade
216              Upgrade legacy authentication to OAuth
217
218       oauth.verify REQUEST-TOKEN REQUEST-TOKEN-SECRET VERIFIER
219              Verify an OAuth request from `oauth.create'
220
221       panda.getList
222              get the current list of pandas
223
224       panda.getPhotos PANDA
225              ask a PANDA for a list of recent public and safe photos
226
227       people.findByEmail EMAIL
228              get a user's NSID from their EMAIL address
229
230       people.findByUsername USERNAME
231              get a user's NSID from their USERNAME
232
233       people.getGroups USER-ID [GROUP-EXTRAS]
234              Get list of groups USER-ID is a member of
235
236       people.getInfo USER-NSID
237              Get information about one person with id USER-NSID
238
239       people.getPhotos USER-NSID
240              Get photos from user USER-NSID with optional parameters
241              safe-search 1-3
242              min-upload-date DATE
243              max-upload-date DATE
244              min-taken date DATE
245              max-taken-date DATE
246              content-type 1-7
247              privacy-filter 1-5
248              per-page PER-PAGE
249              page PAGE
250              format FORMAT
251
252       people.getPhotosOf USER-NSID [PER-PAGE [PAGE [FORMAT]]]
253              Get public photos of a user USER-NSID
254
255       people.getPublicGroups USER-NSID
256              Get list of public groups a user is a member of
257
258       people.getPublicPhotos USER-NSID [PER-PAGE [PAGE [FORMAT]]]
259              Get public photos for a user USER-NSID
260
261       people.getUploadStatus
262              Get calling user upload status
263
264       photos.addTags PHOTO-ID TAGS
265              Add TAGS to a PHOTO-ID.
266
267       photos.comments.addComment PHOTO-ID TEXT
268              Add a photo comment TEXT to PHOTO-ID.
269
270       photos.comments.deleteComment COMMENT-ID
271              Delete a photo comment COMMENT-ID.
272
273       photos.comments.editComment COMMENT-ID TEXT
274              Edit a photo comment COMMENT-ID to have new TEXT.
275
276       photos.comments.getList PHOTO-ID
277              Get the comments for a photo PHOTO-ID.
278
279       photos.comments.getRecentForContacts [PARAMS]
280              Get the list of photos for user contacts with recent comments
281              since DATE-LAST-COMMENT filter CONTACTS-FILTER
282              per-page PER-PAGE page PAGE format FORMAT
283
284       photos.delete PHOTO-ID
285              Delete a PHOTO-ID.
286
287       photos.geo.getLocation PHOTO-ID
288              Get the geo location for a photo PHOTO-ID.
289
290       photos.geo.getPerms PHOTO-ID
291              Get the geo perms for a photo PHOTO-ID.
292
293       photos.geo.removeLocation PHOTO-ID
294              Remove the location for a photo PHOTO-ID.
295
296       photos.geo.setLocation PHOTO-ID LAT LONG ACCURACY
297              Set the location for a photo PHOTO-ID.
298
299       photos.geo.setPerms PHOTO-ID IS-PUBLIC IS-CONTACT IS-FRIEND IS-FAMILY
300              Set the geo perms for a photo PHOTO-ID.
301
302       photos.getAllContexts PHOTO-ID
303              Get all visible sets and pools the PHOTO-ID belongs to.
304
305       photos.getContactsPhotos
306              Get a list of recent photos from the calling users' contacts
307
308       photos.getContactsPublicPhotos USER-NSID [FORMAT]
309              Get a list of recent public photos from USER-NSID's contacts
310
311       photos.getContext PHOTO-ID
312              Get next and previous photos for a PHOTO-ID in a photostream.
313
314       photos.getCounts DATES TAKEN-DATES
315              Get the counts for a set of DATES or TAKEN-DATES.
316
317       photos.getExif PHOTO-ID
318              Get EXIF information about one photo with id PHOTO-ID
319
320       photos.getFavorites PHOTO-ID [PER-PAGE [PAGE]]
321              Get favourites information about one photo with id PHOTO-ID
322
323       photos.getInfo PHOTO-ID [SECRET]
324              Get information about one photo PHOTO-ID with optional SECRET
325
326       photos.getNotInSet [PER-PAGE [PAGE [FORMAT]]]
327              Get list of photos that are not in any set
328
329       photos.getPerms PHOTO-ID
330              Get a photo viewing and commenting permissions
331
332       photos.getRecent [PER-PAGE [PAGE [FORMAT]]]
333              Get list of recent photos
334
335       photos.getSizes PHOTO-ID
336              Get sizes of a PHOTO-ID
337
338       photos.getUntagged [PER-PAGE [PAGE [FORMAT]]]
339              Get list of photos that are not tagged
340
341       photos.getWithGeoData [PER-PAGE [PAGE [FORMAT]]]
342              Get list of photos that have geo data
343
344       photos.getWithoutGeoData [PER-PAGE [PAGE [FORMAT]]]
345              Get list of photos that do not have geo data
346
347       photos.licenses.getInfo
348              Get list of available photo licenses
349
350       photos.licenses.setLicense PHOTO-ID LICENSE-ID
351              Get photo PHOTO-ID license to LICENSE-ID
352
353       photos.notes.add PHOTO-ID X Y W H TEXT
354              Add a note (X, Y, W, H, TEXT) to a photo with id PHOTO-ID
355
356       photos.notes.delete NOTE-ID
357              Delete a note with id NOTE-ID
358
359       photos.notes.edit NOTE-ID X Y W H TEXT
360              Edit note NOTE-ID to (X, Y, W, H, TEXT)
361
362       photos.people.add PHOTO-ID USER-ID X Y W H
363              Mark USER-ID appearing in PHOTO-ID at (X, Y, W, H)
364
365       photos.people.delete PHOTO-ID USER-ID
366              Mark USER-ID as not appearing in PHOTO-ID
367
368       photos.people.deleteCoords PHOTO-ID USER-ID
369              Mark USER-ID as not appearing at coordinates in PHOTO-ID
370
371       photos.people.editCoords PHOTO-ID USER-ID X Y W H
372              Update USER-ID appearing in PHOTO-ID to coords (X, Y, W, H)
373
374       photos.people.getList PHOTO-ID
375              Get list of users appearing in PHOTO-ID
376
377       photos.recentlyUpdated MIN-DATE [PER-PAGE [PAGE [FORMAT]]]
378              Get list of photos that were recently updated
379
380       photos.removeTag PHOTO-ID TAG-ID
381              Remove a tag TAG-ID from a photo.
382
383       photos.search [PARAMS] tags TAGS...
384              Search for photos/videos with many optional parameters
385              user USER
386              tag-mode any|all
387              text TEXT
388              (min|max)-(upload|taken)-date DATE
389              license LICENSE
390              privacy PRIVACY
391              bbox a,b,c,d
392              sort                 date-(posted|taken)-(asc|desc)|interesting‐
393              ness-(desc|asc)|relevance
394              accuracy 1-16
395              safe-search 1-3
396              type 1-4
397              machine-tags TAGS
398              machine-tag-mode any|all
399              group-id ID
400              place-id ID
401              extras EXTRAS
402              per-page PER-PAGE
403              page PAGES
404              media all|photos|videos
405              has-geo
406              lat LAT lon LON radius RADIUS radius-units km|mi
407              contacts (all|ff)
408              format FORMAT
409              woeid WOEID
410              geo-context 1-2
411              in-commons
412              in-gallery
413
414       photos.setContentType PHOTO-ID TYPE
415              Set photo TYPE to one of 'photo', 'screenshot' or 'other'
416
417       photos.setDates PHOTO-ID POSTED TAKEN GRANULARITY
418              Set a photo POSTED date, TAKEN date with GRANULARITY
419
420       photos.setMeta PHOTO-ID TITLE DESCRIPTION
421              Set a photo TITLE and DESCRIPTION
422
423       photos.setPerms PHOTO-ID  IS-PUBLIC  IS-FRIEND  IS-FAMILY  PERM-COMMENT
424       PERM-ADDMETA
425              Set a photo viewing and commenting permissions
426
427       photos.setSafetyLevel PHOTO-ID SAFETY-LEVEL HIDDEN
428              Set a photo's SAFETY-LEVEL and HIDDEN flag
429
430       photos.setTags PHOTO-ID TAGS
431              Set the tags for a PHOTO-ID to TAGS.
432
433       photos.transform.rotate PHOTO-ID DEGREES
434              Rotate PHOTO-ID by 90/180/270 DEGREES
435
436       photos.upload.checkTickets TICKET-IDS...
437              Get the status of upload TICKET-IDS
438
439       photosets.addPhoto PHOTOSET-ID PHOTO-ID
440              Add PHOTO-ID to a PHOTOSET-ID.
441
442       photosets.comments.addComment PHOTOSET-ID TEXT
443              Add a comment TEXT to photoset PHOTOSET-ID.
444
445       photosets.comments.deleteComment COMMENT-ID
446              Delete a photoset comment COMMENT-ID.
447
448       photosets.comments.editComment COMMENT-ID TEXT
449              Edit a photoset comment COMMENT-ID to have new TEXT.
450
451       photosets.comments.getList PHOTOSET-ID
452              Get the comments for a photoset PHOTOSET-ID.
453
454       photosets.create TITLE DESCRIPTION PRIMARY-PHOTO-ID
455              Create a photoset with TITLE, DESCRIPTION and PRIMARY-PHOTO-ID.
456
457       photosets.delete PHOTOSET-ID
458              Delete a photoset with PHOTOSET-ID.
459
460       photosets.editMeta PHOTOSET-ID TITLE DESCRIPTION
461              Set the TITLE and/or DESCRIPTION of a PHOTOSET-ID.
462
463       photosets.editPhotos PHOTOSET-ID PRIMARY-PHOTO-ID PHOTO-IDS,...
464              Set the PHOTO-IDs of a PHOTOSET-ID and PRIMARY-PHOTO-ID.
465
466       photosets.getContext PHOTO-ID PHOTOSET-ID
467              Get next and previous photos for PHOTO-ID in PHOTOSET-ID.
468
469       photosets.getInfo PHOTOSET-ID
470              Get information about PHOTOSET-ID.
471
472       photosets.getList [USER-NSID]
473              Get the list of photosets for the USER-NSID.
474
475       photosets.getPhotos  PHOTOSET-ID [EXTRAS [PRIVACY [PER-PAGE [PAGE [FOR‐
476       MAT]]]]]
477              Get the list of photos in PHOTOSET-ID with options.
478
479       photosets.orderSets PHOTOSET-IDS...
480              Set the order of sets PHOTOSET-IDS.
481
482       photosets.removePhoto PHOTOSET-ID PHOTO-ID
483              Remove PHOTO-ID from PHOTOSET-ID.
484
485       photosets.removePhotos PHOTOSET-ID PHOTO-IDS...
486              Remove PHOTO-IDS from PHOTOSET-ID.
487
488       photosets.reorderPhotos PHOTOSET-ID PHOTO-IDS...
489              Reorder PHOTO-IDS from PHOTOSET-ID.
490
491       photosets.setPrimaryPhoto PHOTOSET-ID PHOTO-ID
492              Set photoset PHOTOSET-ID primary photo to PHOTO-ID.
493
494       places.find TEXT
495              Find places by TEXT query.
496
497       places.findByLatLon LAT LON ACCURACY
498              Find places by LAT and LON with ACCURACY 1-16.
499
500       places.getChildrenWithPhotosPublic PLACE-ID|- [WOE-ID|-]
501              Find child places with public photos by PLACE-ID or WOE-ID
502
503       places.getInfo PLACE-ID|- [WOE-ID|-]
504              Find place by PLACE-ID or WOE-ID
505
506       places.getInfoByUrl URL
507              Find place by place URL
508
509       places.getPlaceTypes URL
510              Get a list of available place types
511
512       places.getShapeHistory PLACE-ID|- [WOE-ID|-]
513              Get history of shapes for a place by PLACE-ID or WOE-ID
514
515       places.getTopPlacesList PLACE-TYPE [DATE [WOE-ID|- [PLACE-ID]]]
516              Get the top 100 most geotagged places for a DATE (or yesterday).
517
518       places.placesForBoundingBox PLACE-TYPE MIN-LONG MIN-LAT  MAX-LONG  MAX-
519       LAT
520              Find user places of PLACE-TYPE in bbox.
521
522       places.placesForContacts   PLACE-TYPE   WOE-ID|-  PLACE-ID|-  THRESHOLD
523       [PARAMS]
524              Find top 100 unique places clustered by a given PLACE-TYPE for a
525              user's contacts with optional parameters
526              contacts CONTACTS
527              min-upload MIN-UPLOAD-DATE
528              max-upload MAX-UPLOAD-DATE
529              min-taken MIN-TAKEN-DATE
530              max-taken MAX-TAKEN-DATE
531
532       places.placesForUser PLACE-TYPE [WOE-ID] [PLACE-ID [THRESHOLD]]]
533              Find user places of PLACE-TYPE.
534
535       places.resolvePlaceId PLACE-ID  / WOE-ID
536              Find places information by PLACE-ID or WOE-ID (number).
537
538       places.resolvePlaceURL PLACE-URL
539              Find places information by PLACE-URL.
540
541       places.tagsForPlace PLACE-ID|- [WOE-ID|-]
542              Get tags for a place by PLACE-ID or WOE-ID with optional parame‐
543              ters
544              min-upload MIN-UPLOAD-DATE
545              max-upload MAX-UPLOAD-DATE
546              min-taken MIN-TAKEN-DATE
547              max-taken MAX-TAKEN-DATE
548
549       prefs.getContentType
550              Get default content type preference for user.
551
552       prefs.getGeoPerms
553              Get default privacy level for geographic info for user.
554
555       prefs.getHidden
556              Get default hidden preference for user.
557
558       prefs.getPrivacy
559              Get default privacy preference for user.
560
561       prefs.getSafetyLevel
562              Get default safety level for user.
563
564       reflection.getMethodInfo NAME
565              Get information about an API method NAME
566
567       reflection.getMethods
568              Get API methods
569
570       replace FILE PHOTO-ID [async]
571              Replace a photo PHOTO-ID with a new FILE (async)
572
573       shorturi PHOTO-ID
574              Get the http://flic.kr short uri for PHOTO-ID
575
576       stats.getCollectionDomains DATE [COLLECTION-ID [PER-PAGE [PAGE]]]
577              Get collection domains stats
578
579       stats.getCollectionReferrers   DATE   DOMAIN  [COLLECTION-ID  [PER-PAGE
580       [PAGE]]]
581              Get collection referrers stats
582
583       stats.getCollectionStats DATE COLLECTION-ID
584              Get collection view count stats
585
586       stats.getPhotoDomains DATE [PHOTO-ID [PER-PAGE [PAGE]]]
587              Get photo domains stats
588
589       stats.getPhotoReferrers DATE DOMAIN [PHOTO-ID [PER-PAGE [PAGE]]]
590              Get photo referrers stats
591
592       stats.getPhotoStats DATE PHOTO-ID
593              Get photo view count stats
594
595       stats.getPhotosetDomains DATE [PHOTOSET-ID [PER-PAGE [PAGE]]]
596              Get photoset domains stats
597
598       stats.getPhotosetReferrers DATE DOMAIN [PHOTOSET-ID [PER-PAGE [PAGE]]]
599              Get photoset referrers stats
600
601       stats.getPhotosetStats DATE PHOTOSET-ID
602              Get photoset view count stats
603
604       stats.getPhotostreamDomains DATE [PER-PAGE [PAGE]]
605              Get photostream domains stats
606
607       stats.getPhotostreamReferrers DATE DOMAIN [PER-PAGE [PAGE]]
608              Get photostream referrers stats
609
610       stats.getPhotostreamStats DATE
611              Get photostream view count stats
612
613       stats.getPopularPhotos [DATE [SORT [PER-PAGE [PAGE [EXTRAS]]]]]
614              Get popular photos stats
615
616       stats.getTotalViews [DATE]
617              Get total stats
618
619       tags.getClusters TAG
620              Get list of tag clusters for TAG
621
622       tags.getHotList [PERIOD [COUNT]]
623              Get the list of hot tags for the given PERIOD (day, week)
624
625       tags.getListPhoto PHOTO-ID
626              Get the tag list for a PHOTO-ID.
627
628       tags.getListUser [USER-NSID]
629              Get the tag list for a USER-NSID (or current user).
630
631       tags.getListUserPopular [USER-NSID [COUNT]]
632              Get the popular tag list for a USER-NSID (or current user).
633
634       tags.getListUserRaw [TAG]
635              Get the raw versions of a TAG (or  all  tags)  for  the  current
636              user.
637
638       tags.getMostFrequentlyUsed
639              Get the most frequently used tags for the current user.
640
641       tags.getRelated TAG
642              Get  a  list  of  tags 'related' to TAG based on clustered usage
643              analysis.
644
645       test.echo KEY VALUE
646              Test echo API call; echos KEY VALUE
647
648       test.login
649              Test login API call: returns username
650
651       test.null KEY VALUE
652              Test null API call: no return
653
654       upload FILE [PARAMS...]
655              Upload a photo FILE with  optional  parameters  PARAM  or  PARAM
656              VALUE
657              title TITLE
658              description DESC
659              safety_level 'safe' (default) or 'moderate' or 'restricted'
660              content_type 'photo' (default) or screenshot' or 'other'
661              hidden 'public' (default) or 'hidden'
662              friend
663              public
664              family
665              tags TAGS... [must be last param]
666
667       urls.getGroup GROUP-ID
668              Get the url of the group page for GROUP-ID.
669
670       urls.getUserPhotos USER-NSID
671              Get the url of the photo page for USER-NSID.
672
673       urls.getUserProfile USER-NSID
674              Get the url of the profile page for USER-NSID.
675
676       urls.lookupGroup URL
677              Get a group NSID from the URL to a group's page or photo pool.
678
679       urls.lookupUser URL
680              Get a user NSID from the URL to a user's photo
681

Extras Fields

683       The  EXTRAS  parameter  can take a comma-separated set of the following
684       values
685
686       date_taken
687              Date item was taken
688
689       date_upload
690              Date item was uploaded
691
692       geo    Geotagging latitude, longitude and accuracy
693
694       icon_server
695              Item owner icon fields
696
697       last_update
698              Date item was last updated
699
700       license
701              Item License
702
703       machine_tags
704              Machine tags
705
706       media  Item Format: photo or video
707
708       o_dims Original item dimensions
709
710       original_format
711              Original item secret and format
712
713       owner_name
714              Item owner ID
715
716       path_alias
717              Path alias for owner like /photos/USERNAME
718
719       tags   Item clean tags (safe for HTML, URLs)
720
721       url_c  URL of medium 800, 800 on longest size image
722
723       url_m  URL of small, medium size image
724
725       url_n  URL of small, 320 on longest side size image
726
727       url_o  URL of original size image
728
729       url_q  URL of large square 150x150 size image
730
731       url_s  URL of small suqare 75x75 size image
732
733       url_sq URL of square size image
734
735       url_t  URL of thumbnail, 100 on longest side size image
736
737       views  Number of times item has been viewed
738

Photos List Feed Formats

740       The FORMAT parameter can take any of the following values
741
742       feed-rss_100
743              RSS 1.0
744
745       feed-rss_200
746              RSS 2.0
747
748       feed-atom_10
749              Atom 1.0
750
751       feed-georss
752              RSS 2.0 with GeoRSS and W3C Geo for geotagged photos
753
754       feed-geoatom
755              Atom 1.0 with GeoRSS and W3C Geo for geotagged photos
756
757       feed-geordf
758              RSS 1.0 with GeoRSS and W3C Geo for geotagged photos
759
760       feed-kml
761              KML 2.1
762
763       feed-kml_nl
764              KML 2.1 network link
765

AUTHOR

770       flickcurl was written by David Beckett.
771
772       This manual page was written by Kumar  Appaiah  <akumar@ee.iitm.ac.in>,
773       for the Debian project (but may be used by others).
774
775
776
777                               1 September 2008                   FLICKCURL(1)