FLICKCURL(1)

✨ FLICKCURL(1) ✨

okay bestie, welcome to the General Commands Manual glow-up of FLICKCURL(1) 💖 this is the whole thing, every flag, every command, no skips, periodt.

---

🌸 NAME 🌸

flickcurl — call Flickr API. that's it, that's the name, she's simple and she's iconic 🎀

---

🦋 SYNOPSIS 🦋

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

---

💫 DESCRIPTION 💫

so flickcurl is a utility program that calls the Flickr APIs through the flickcurl library 🫶. run flickcurl -h and she'll hand you the whole list of supported commands plus their arguments. no cap.

⚠️ bestie listen — the program needs to be configured before use to actually work with the Flickr APIs. run flickcurl with no options at all and it gives you the instructions for registering the application and creating the initial configuration file ~/.flickcurl.conf out of your registration info. do that first, fr fr.

---

💅 OPTIONS 💅

these programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). summary of options is right here below, mwah:

• -a FROB, --auth FROB — authenticate with a FROB and update the authentication file. and then? the program exits right after updating the file. bye 👋
• -d DELAY, --delay DELAY — set the delay between requests to DELAY milliseconds.
• -h, --help — show summary of options and exit. the classic.
• -o FILE, --output FILE — write the results of format feed API calls to FILE 📝
• -q, --quiet — display less information while the program runs. shhh 🤫
• -v, --version — display the version of the program and exit.
• -V, --verbose — display more information while the program runs. tell me everything 🔥

---

👑 COMMANDS 👑

in the following list of commands, keep these two lil rules in your head:

• PER-PAGE is photos per result page, or - for default (10)
• PAGE is result page number, or - for default (1 = first page)

now the main event, the whole roster, alphabetically, and yes we're doing all of them 💜

• 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.getServices — get a list of blog services.
• blogs.postPhoto BLOG-ID PHOTO-ID TITLE DESCRIPTION [BLOG-PASSWORD] — post PHOTO-ID to blog BLOG-ID with TITLE, DESCRIPTION and optional password.
• collections.getInfo COLLECTION-ID — get information on collection COLLECTION-ID.
• collections.getTree [COLLECTION-ID|- [USER-ID|-]] — get tree of collections COLLECTION-ID for USER-ID.
• commons.getInstitutions — get list of institutions.
• contacts.getList [FILTER [PER-PAGE [PAGE]]] — get a list of contacts with optional FILTER.
• contacts.getListRecentlyUploaded [DATE-LAST-UPLOAD [FILTER]] — get a list of recent uploading contacts since DATE-LAST-UPLOAD with optional FILTER.
• contacts.getPublicList USER-NSID [PER-PAGE [PAGE]] — get the contact list for user USER-NSID.
• contacts.getTaggingSuggestions [PER_PAGE [PAGE [INCLUDE-SELF [INCLUDE-ADDRESS-BOOK]]]] — get tagging suggestions.
• favorites.add PHOTO-ID — adds PHOTO-ID to the current user's favorites.
• favorites.getContext PHOTO-ID USER-NSID [NUM-PREV [NUM-NEXT [EXTRAS]]] — get context photos around USER-ID's favorite PHOTO-ID.
• favorites.getList USER-NSID [PER-PAGE [PAGE [FORMAT]]] — get a list of USER-NSID's favorite photos.
• favorites.getPublicList USER-NSID [PER-PAGE [PAGE [FORMAT]]] — get a list of USER-NSID's favorite public photos.
• favorites.remove PHOTO-ID — removes PHOTO-ID to the current user's favorites.
• galleries.addPhoto GALLERY-ID PHOTO-ID TEXT — add photo PHOTO-ID to galleries GALLERY-ID with TEXT.
• galleries.create TITLE [DESCRIPTION [PRIMARY-PHOTO-ID] — create a new gallery with TITLE, DESCRIPTION and PRIMARY-PHOTO-ID.
• galleries.editMeta GALLERY-ID TITLE [DESCRIPTION] — set the TITLE and/or DESCRIPTION of a GALLERY-ID.
• galleries.editPhoto GALLERY-ID PHOTO-ID COMMENT — set the COMMENT for PHOTO-ID in GALLERY-ID.
• galleries.editPhotos GALLERY-ID PRIMARY-PHOTO-ID PHOTO-IDS,... — set the PHOTO-IDs of a GALLERY-ID and PRIMARY-PHOTO-ID.
• galleries.getInfo GALLERY-ID — get information about GALLERY-ID.
• galleries.getList USER-ID [PER-PAGE [PAGE]] — get list of galleries for a USER-ID with optional paging.
• galleries.getListForPhoto PHOTO-ID [PER-PAGE [PAGE]] — get list of galleries PHOTO-ID appears in with optional paging.
• galleries.getPhotos GALLERY-ID [EXTRAS [PER-PAGE [PAGE [FORMAT]]]] — get the list of photos in GALLERY-ID with options.
• getphotoid IMAGE-URL — get the photo id from a raw flickr farm IMAGE-URL.
• 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.join GROUP-ID [ACCEPT-RULES] — join a group GROUP-ID with optional accepting of rules.
• groups.joinRequest GROUP-ID MESSAGE ACCEPT-RULES — request to join a group GROUP-ID using MESSAGE and accept rules.
• groups.leave GROUP-ID [DELETE-PHOTOS] — leave a group GROUP-ID and optionally delete photos.
• groups.members.getList GROUP-ID [MEMBER-TYPES [PER-PAGE [PAGE]]] — get list of MEMBER-TYPES types members of group GROUP-ID.
• 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 [PER-PAGE [PAGE]] — get list of groups a user can add to.
• groups.pools.getPhotos GROUP-ID [PER-PAGE [PAGE [FORMAT]]] — 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
  • format FORMAT
• machinetags.getNamespaces [PREDICATE [PER-PAGE [PAGE]]] — get a list of namespaces with optional PREDICATE.
• machinetags.getPairs [NAMESPACE [PREDICATE [PER-PAGE [PAGE]]]] — get a list of unique NAMESPACE and PREDICATE pairs.
• machinetags.getPredicates [NAMESPACE [PER-PAGE [PAGE]]] — get a list of unique predicates optionally by NAMESPACE.
• machinetags.getRecentValues [NAMESPACE|- [PREDICATE|- [ADDED-SINCE]]] — get a list of recent machinetags for NAMESPACE and PREDICATE since ADDED-SINCE.
• machinetags.getValues NAMESPACE PREDICATE [PER-PAGE [PAGE]] — get a list of unique values for a NAMESPACE and PREDICATE.
• oauth.create [CALLBACK] — create OAuth request token/secret pair and show the authentication URL.
• oauth.upgrade — upgrade legacy authentication to OAuth.
• oauth.verify REQUEST-TOKEN REQUEST-TOKEN-SECRET VERIFIER — verify an OAuth request from oauth.create.
• panda.getList — get the current list of pandas 🐼 (yes really, she said pandas)
• panda.getPhotos PANDA — ask a PANDA for a list of recent public and safe photos.
• people.findByEmail EMAIL — get a user's NSID from their EMAIL address.
• people.findByUsername USERNAME — get a user's NSID from their USERNAME.
• people.getGroups USER-ID [GROUP-EXTRAS] — get list of groups USER-ID is a member of.
• people.getInfo USER-NSID — get information about one person with id USER-NSID.
• people.getPhotos USER-NSID — get photos from user USER-NSID with optional parameters:
  • safe-search 1-3
  • min-upload-date DATE
  • max-upload-date DATE
  • min-taken date DATE
  • max-taken-date DATE
  • content-type 1-7
  • privacy-filter 1-5
  • per-page PER-PAGE
  • page PAGE
  • format FORMAT
• people.getPhotosOf USER-NSID [PER-PAGE [PAGE [FORMAT]]] — get public photos of a user USER-NSID.
• people.getPublicGroups USER-NSID — get list of public groups a user is a member of.
• people.getPublicPhotos USER-NSID [PER-PAGE [PAGE [FORMAT]]] — get 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.comments.getRecentForContacts [PARAMS] — get the list of photos for user contacts with recent comments since DATE-LAST-COMMENT filter CONTACTS-FILTER per-page PER-PAGE page PAGE format FORMAT.
• 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.setLocation 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 [FORMAT] — 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 [SECRET] — get information about one photo PHOTO-ID with optional SECRET.
• photos.getNotInSet [PER-PAGE [PAGE [FORMAT]]] — 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 [FORMAT]]] — get list of recent photos.
• photos.getSizes PHOTO-ID — get sizes of a PHOTO-ID.

---

...and that's only part 1, bestie — keep scrolling, there's more coming 🫶✨

• photos.getUntagged [PER-PAGE [PAGE [FORMAT]]] — bestie, this one pulls the list of photos that are not tagged. untagged chaos. 💅
• photos.getWithGeoData [PER-PAGE [PAGE [FORMAT]]] — gives you the photos that have geo data. location girlies rise. 🌍✨
• photos.getWithoutGeoData [PER-PAGE [PAGE [FORMAT]]] — the opposite: photos with zero geo data. no location, just vibes. 🫥
• photos.licenses.getInfo — shows you all the available photo licenses. legal bestie moment. 📜
• photos.licenses.setLicense PHOTO-ID LICENSE-ID — sets the license for PHOTO-ID to LICENSE-ID. slay. 💅
• photos.notes.add PHOTO-ID X Y W H TEXT — adds a note at (X, Y, W, H, TEXT) to the photo with id PHOTO-ID. sticky note energy. 📝
• photos.notes.delete NOTE-ID — deletes the note with id NOTE-ID. bye bestie. 👋
• photos.notes.edit NOTE-ID X Y W H TEXT — edits note NOTE-ID to be (X, Y, W, H, TEXT). glow up. ✨
• photos.people.add PHOTO-ID USER-ID X Y W H — marks USER-ID as appearing in PHOTO-ID at (X, Y, W, H). tag ur bestie. 🫶
• photos.people.delete PHOTO-ID USER-ID — marks USER-ID as not appearing in PHOTO-ID. removing the tag, no hard feelings. 💔
• photos.people.deleteCoords PHOTO-ID USER-ID — marks USER-ID as not appearing at the coordinates in PHOTO-ID. just the coords, not the person. 📍
• photos.people.editCoords PHOTO-ID USER-ID X Y W H — updates USER-ID appearing in PHOTO-ID to coords (X, Y, W, H). move over. 📐
• photos.people.getList PHOTO-ID — gets the list of users appearing in PHOTO-ID. the cast list. 🎬
• photos.recentlyUpdated MIN-DATE [PER-PAGE [PAGE [FORMAT]]] — gives you photos updated since MIN-DATE, with optional PER-PAGE, PAGE, FORMAT. fresh drops only. 🔥
• photos.removeTag PHOTO-ID TAG-ID — removes tag TAG-ID from a photo. untagging era. 🚫
• photos.search [PARAMS] tags TAGS... — searches for photos/videos with a lot of optional parameters. it's giving search queen. 🔍
  • 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)
  • format FORMAT
  • woeid WOEID
  • geo-context 1-2
  • in-commons
  • in-gallery
• photos.setContentType PHOTO-ID TYPE — sets photo TYPE to one of 'photo', 'screenshot' or 'other'. choose ur fighter. 📸
• photos.setDates PHOTO-ID POSTED TAKEN GRANULARITY — sets a photo's POSTED date and TAKEN date with GRANULARITY. time travel but make it metadata. ⏰
• photos.setMeta PHOTO-ID TITLE DESCRIPTION — sets a photo's TITLE and DESCRIPTION. caption glow-up. ✍️
• photos.setPerms PHOTO-ID IS-PUBLIC IS-FRIEND IS-FAMILY PERM-COMMENT PERM-ADDMETA — sets a photo's viewing and commenting permissions. who can see, who can comment. 👀
• photos.setSafetyLevel PHOTO-ID SAFETY-LEVEL HIDDEN — sets a photo's SAFETY-LEVEL and HIDDEN flag. keep it safe or keep it hidden. 🛡️
• photos.setTags PHOTO-ID TAGS — sets the tags for PHOTO-ID to TAGS. tag overhaul. 🏷️
• photos.transform.rotate PHOTO-ID DEGREES — rotates PHOTO-ID by 90/180/270 DEGREES. spin that pic. 🔄
• photos.upload.checkTickets TICKET-IDS... — gets the status of upload TICKET-IDS. checking the queue. 🎟️
• photosets.addPhoto PHOTOSET-ID PHOTO-ID — adds PHOTO-ID to a PHOTOSET-ID. album expansion. 📁
• photosets.comments.addComment PHOTOSET-ID TEXT — adds comment TEXT to photoset PHOTOSET-ID. comment section activated. 💬
• photosets.comments.deleteComment COMMENT-ID — deletes a photoset comment COMMENT-ID. delete and don't look back. 🗑️
• photosets.comments.editComment COMMENT-ID TEXT — edits photoset comment COMMENT-ID to have new TEXT. rewrite the narrative. ✏️
• photosets.comments.getList PHOTOSET-ID — gets the comments for a photoset PHOTOSET-ID. read the room. 📖
• photosets.create TITLE DESCRIPTION PRIMARY-PHOTO-ID — creates a photoset with TITLE, DESCRIPTION and PRIMARY-PHOTO-ID. new album, who dis? 🎀
• photosets.delete PHOTOSET-ID — deletes a photoset with PHOTOSET-ID. gone girl. 💀
• photosets.editMeta PHOTOSET-ID TITLE DESCRIPTION — sets the TITLE and/or DESCRIPTION of a PHOTOSET-ID. metadata makeover. 💅
• photosets.editPhotos PHOTOSET-ID PRIMARY-PHOTO-ID PHOTO-IDS,... — sets the PHOTO-IDs of a PHOTOSET-ID and PRIMARY-PHOTO-ID. rearrange the whole vibe. 🔀
• photosets.getContext PHOTO-ID PHOTOSET-ID — gets next and previous photos for PHOTO-ID in PHOTOSET-ID. context clues. 🔍
• photosets.getInfo PHOTOSET-ID — gets info about PHOTOSET-ID. the tea. ☕
• photosets.getList [USER-NSID] — gets the list of photosets for the USER-NSID. album inventory. 📚
• photosets.getPhotos PHOTOSET-ID [EXTRAS [PRIVACY [PER-PAGE [PAGE [FORMAT]]]]] — gets the list of photos in PHOTOSET-ID with options. full album dump. 📸
• photosets.orderSets PHOTOSET-IDS... — sets the order of sets PHOTOSET-IDS. arrange ur shelves. 🗂️
• photosets.removePhoto PHOTOSET-ID PHOTO-ID — removes PHOTO-ID from PHOTOSET-ID. out of the album. 🚪
• photosets.removePhotos PHOTOSET-ID PHOTO-IDS... — removes PHOTO-IDS from PHOTOSET-ID. mass removal. 🧹
• photosets.reorderPhotos PHOTOSET-ID PHOTO-IDS... — reorders PHOTO-IDS from PHOTOSET-ID. new sequence, new me. 🔢
• photosets.setPrimaryPhoto PHOTOSET-ID PHOTO-ID — sets photoset PHOTOSET-ID primary photo to PHOTO-ID. main character chosen. 👑
• places.find TEXT — finds places by TEXT query. location hunt. 🗺️
• places.findByLatLon LAT LON ACCURACY — finds places by LAT and LON with ACCURACY 1-16. coordinates queen. 📍
• places.getChildrenWithPhotosPublic PLACE-ID|- [WOE-ID|-] — finds child places with public photos by PLACE-ID or WOE-ID. explore the family tree. 🌳
• places.getInfo PLACE-ID|- [WOE-ID|-] — finds place by PLACE-ID or WOE-ID. place intel. 🔎
• places.getInfoByUrl URL — finds place by place URL. link detective. 🔗
• places.getPlaceTypes URL — gets a list of available place types. type taxonomy. 📋
• places.getShapeHistory PLACE-ID|- [WOE-ID|-] — gets history of shapes for a place by PLACE-ID or WOE-ID. shape-shifter lore. 🐍
• places.getTopPlacesList PLACE-TYPE [DATE [WOE-ID|- [PLACE-ID]]] — gets the top 100 most geotagged places for a DATE (or yesterday). leaderboard energy. 🏆
• places.placesForBoundingBox PLACE-TYPE MIN-LONG MIN-LAT MAX-LONG MAX-LAT — finds user places of PLACE-TYPE in bbox. boxed in, but make it cute. 📦
• places.placesForContacts PLACE-TYPE WOE-ID|- PLACE-ID|- THRESHOLD [PARAMS] — finds top 100 unique places clustered by a given PLACE-TYPE for a user's contacts, with optional params. squad places. 👯
  • contacts CONTACTS
  • min-upload MIN-UPLOAD-DATE
  • max-upload MAX-UPLOAD-DATE
  • min-taken MIN-TAKEN-DATE
  • max-taken MAX-TAKEN-DATE
• places.placesForUser PLACE-TYPE [WOE-ID] [PLACE-ID [THRESHOLD]]] — finds user places of PLACE-TYPE. ur places. 📌
• places.resolvePlaceId PLACE-ID / WOE-ID — finds places information by PLACE-ID or WOE-ID (number). resolve the ID. 🆔
• places.resolvePlaceURL PLACE-URL — finds places information by PLACE-URL. URL to place. 🔗
• places.tagsForPlace PLACE-ID|- [WOE-ID|-] — gets tags for a place by PLACE-ID or WOE-ID, with optional params. tag the location. 🏷️
  • min-upload MIN-UPLOAD-DATE
  • max-upload MAX-UPLOAD-DATE
  • min-taken MIN-TAKEN-DATE
  • max-taken MAX-TAKEN-DATE
• prefs.getContentType — gets default content type preference for user. ur default vibe. 🎞️
• prefs.getGeoPerms — gets default privacy level for geographic info for user. geo privacy check. 🛡️
• prefs.getHidden — gets default hidden preference for user. hidden or not. 🫣
• prefs.getPrivacy — gets default privacy preference for user. privacy settings tea. 🔒
• prefs.getSafetyLevel — gets default safety level for user. safety first. ⚠️
• reflection.getMethodInfo NAME — gets info about an API method NAME. method lore. 📖
• reflection.getMethods — gets API methods. the whole method list. 📜
• replace FILE PHOTO-ID [async] — replaces photo PHOTO-ID with a new FILE (async). glow-up swap. 🔄
• shorturi PHOTO-ID — gets the http://flic.kr short uri for PHOTO-ID. short link slay. 🔗
• stats.getCollectionDomains DATE [COLLECTION-ID [PER-PAGE [PAGE]]] — gets collection domains stats. domain tea. 📊
• stats.getCollectionReferrers DATE DOMAIN [COLLECTION-ID [PER-PAGE [PAGE]]] — gets collection referrers stats. who sent them. 🕵️
• stats.getCollectionStats DATE COLLECTION-ID — gets collection view count stats. numbers don't lie. 🔢
• stats.getPhotoDomains DATE [PHOTO-ID [PER-PAGE [PAGE]]] — gets photo domains stats. photo domain drama. 📸
• stats.getPhotoReferrers DATE DOMAIN [PHOTO-ID [PER-PAGE [PAGE]]] — gets photo referrers stats. referral receipts. 🧾
• stats.getPhotoStats DATE PHOTO-ID — gets photo view count stats. views check. 👀
• stats.getPhotosetDomains DATE [PHOTOSET-ID [PER-PAGE [PAGE]]] — gets photoset domains stats. album domains. 📁
• stats.getPhotosetReferrers DATE DOMAIN [PHOTOSET-ID [PER-PAGE [PAGE]]] — gets photoset referrers stats. album referrals. 📈
• stats.getPhotosetStats DATE PHOTOSET-ID — gets photoset view count stats. album views. 🎞️
• stats.getPhotostreamDomains DATE [PER-PAGE [PAGE]] — gets photostream domains stats. stream domains. 🌊
• stats.getPhotostreamReferrers DATE DOMAIN [PER-PAGE [PAGE]] — gets photostream referrers stats. stream referrals. 🌊
• stats.getPhotostreamStats DATE — gets photostream view count stats. stream views. 🌊
• stats.getPopularPhotos [DATE [SORT [PER-PAGE [PAGE [EXTRAS]]]]] — gets popular photos stats. the it-list. 🔥
• stats.getTotalViews [DATE] — gets total stats. all the views. 📈
• tags.getClusters TAG — gets list of tag clusters for TAG. cluster era. 🫧
• tags.getHotList [PERIOD [COUNT]] — gets the list of hot tags for the given PERIOD (day, week). hot tag summer. 🔥
• tags.getListPhoto PHOTO-ID — gets the tag list for a PHOTO-ID. tags on tags. 🏷️
• tags.getListUser [USER-NSID] — gets the tag list for a USER-NSID (or current user). ur tags. 🏷️
• tags.getListUserPopular [USER-NSID [COUNT]] — gets the popular tag list for a USER-NSID (or current user). top tags. 📈
• tags.getListUserRaw [TAG] — gets the raw versions of a TAG (or all tags) for the current user. raw and unfiltered. 🍓
• tags.getMostFrequentlyUsed — gets the most frequently used tags for the current user. tag faves. 💖
• tags.getRelated TAG — gets a list of tags 'related' to TAG based on clustered usage analysis. tag astrology. 🔮
• test.echo KEY VALUE — test echo API call; echos KEY VALUE. echo echo. 🗣️
• test.login — test login API call: returns username. login check. 🔑
• test.null KEY VALUE — test null API call: no return. nothing to see here. 🕳️
• upload FILE [PARAMS...] — uploads a photo FILE with optional params PARAM or PARAM VALUE. upload szn. ⬆️
  • title TITLE
  • description DESC
  • safety_level 'safe' (default) or 'moderate' or 'restricted'
  • content_type 'photo' (default) or screenshot' or 'other'
  • hidden 'public' (default) or 'hidden'
  • friend
  • public
  • family
  • tags TAGS... [must be last param]
• urls.getGroup GROUP-ID — gets the url of the group page for GROUP-ID. group link. 🔗
• urls.getUserPhotos USER-NSID — gets the url of the photo page for USER-NSID. photo page link. 🔗
• urls.getUserProfile USER-NSID — gets the url of the profile page for USER-NSID. profile link. 🔗
• urls.lookupGroup URL — gets a group NSID from the URL to a group's page or photo pool. group ID from link. 🆔
• urls.lookupUser URL — gets a user NSID from the URL to a user's photo. user ID from link. 🆔

✨ Extras Fields ✨

Okay bestie, the EXTRAS parameter? She's a comma-separated lil squad of values, and here's the whole roster. Pick as many as you want, just separate them with commas 💖

• date_taken — the date the item got taken 📸
• date_upload — the date the item got uploaded ⬆️
• geo — geotagging latitude, longitude and accuracy 🌍
• icon_server — item owner icon fields 🎀
• last_update — the date the item was last updated 🕰️
• license — the item License 📜
• machine_tags — machine tags 🤖
• media — item Format: photo or video 🎬
• o_dims — original item dimensions 📐
• original_format — original item secret and format 🤫
• owner_name — item owner ID 👤
• path_alias — path alias for owner, like /photos/USERNAME 🛤️
• tags — item clean tags (safe for HTML, URLs) 🏷️
• url_c — URL of medium 800, 800 on longest size image 🖼️
• url_m — URL of small, medium size image 🌷
• url_n — URL of small, 320 on longest side size image 🌼
• url_o — URL of original size image 💫
• url_q — URL of large square 150x150 size image 🟦
• url_s — URL of small suqare 75x75 size image (yes, "suqare" — that's exactly what the page says, we don't fix the lore, we preserve it 💅)
• url_sq — URL of square size image ⬜
• url_t — URL of thumbnail, 100 on longest side size image 🖾
• views — number of times item has been viewed 👀

---

🌈 Photos List Feed Formats 🌈

And now the FORMAT parameter, who can be literally any of these girlies:

• feed-rss_100 — RSS 1.0 📡
• feed-rss_200 — RSS 2.0 📻
• feed-atom_10 — Atom 1.0 ⚛️
• feed-georss — RSS 2.0 with GeoRSS and W3C Geo for geotagged photos 🗺️
• feed-geoatom — Atom 1.0 with GeoRSS and W3C Geo for geotagged photos 🧭
• feed-geordf — RSS 1.0 with GeoRSS and W3C Geo for geotagged photos 📍
• feed-kml — KML 2.1 🏔️
• feed-kml_nl — KML 2.1 network link 🔗

---

🔍 SEE ALSO

• flickrdf(1).

---

👑 AUTHOR

flickcurl was written by David Beckett. Give her a round of applause, she ate 💅

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

---

and that's the whole page bestie, you made it to the end, so proud of you fr fr 💖✨

this iconic little doc is dated 1 September 2008 and lives under the name FLICKCURL(1) — go forth and curl those flicks, mwah 🎀🦋