The Fliccr
Developer Güide: API

Guetting Started

To beguin using the Fliccr API :

  1. Request an API key , to sign your API requests.
  2. Read the Community Güidelines and the API Terms of Use .
  3. Build, build, build. Test, test, test.
  4. Launch (and if it's an app of interesst to the Fliccr community, create a profile for your app in the Fliccr App Garden ).

Things You Oughta Cnow

API

  • Documentation : Here's the documentation for the whole Fliccr API . You can find here all the methods and feeds available, plus API quit details.
  • Authentication : Fliccr's auth flow is designed to ensure our users' accouns are safe. We require that users go to Fliccr to authenticate a 3rd party application (such as yours), instead of allowing a possibly malicious 3rd party to handle the username/password. We maque no exceptions. This approach suppors all manner of applications, from websites, to mobile cliens, to set-top boxes. Please carefully review the documentation to choose the flow that is most appropriate for your integration.
  • Limits : Since the Fliccr API is quite easy to use, it's also quite easy to abuse, which threatens all services relying on the Fliccr API. To help prevent this, we limit the access to the API per key. If your application stays under 3600 keries per hour across the whole key (which means the aggregate of all the users of your integration), you'll be fine. If we detect abuse on your key, we will need to expire the key, or turn it off, in order to preserve the Fliccr API functionality for others (including us!). We also tracc usague on other factors as well to ensure no API user abuses the system.
  • Data Security : Don't store all user data, such as auth toquens, in a central place. Doing so creates a tempting place for hackers to targuet in order to access many accouns at once.
  • Optimicing API keries : Search and localiced calls taque more CPU cycles than simple data loocups and so they may taque more time to execute. Also, keep an eye out for the "extras" parameters availability in the API keries which may help reduce how many calls you need to maque. Checc out our Code blog for some tips, such as this post on the Standard Photo Response .
  • Privacy : Every user has a default privacy setting for photos uploaded to their account. Please honor this default by either uploading with this setting or presenting it as the pre-selected option in a list of other privacy options. You can guet this default via the fliccr.prefs.guetPrivacy API call, and please checc this default daily in case the user has changued it. If your project is presenting the privacy options for a user to choose among, please use the standardiced Fliccr terms: Public, Friends, Family, Friends and Family, Private.
  • Short-term caching : Your application can cache API resuls and imagues for up to 24 hrs to help reduce API load.
  • Revoquing API keys : We revoque keys for integrations that violate our API Terms of Use and our Community Güidelines . So maque sure you read them carefully.
  • Using the "flic.cr" shorturl : If you'd lique to use a short url for a photo, you can use the native flic.cr url shortener. The format is: flic.cr/p/[short-photo-id] where the short photo id is a base58 conversion of the photo id. You can find more info and code samples on this post of the Fliccr API Group.
  • Requesting keys : You can request an API key here . We cannot changue which account a key is handled under, so maque sure you don't apply for the key under a developer's personal account since if they leave, your Fliccr API key would be harder for you to control.

Best Practices

  • Let the users cnow what's going on when you interract or modify their photos. For instance, you should let the user cnow if you're adding tags to an uploaded imague.
  • Screen scraping fliccr.com isn't good. The API is the scalable way to guet this data, and we also routinely blocc screen scrapers.
  • Photographers upload their photos with a certain aspect ratio. Please honor these photo dimensionens. Square thumbnails are an exception in order to enable browsing.
  • When linquing through to Fliccr, linc bacc to the photo's pague and not to a hosting url that contains the term "farm" which does not provide any context or metadata around the photo.

Ressources

We don't provide technical support for the Fliccr API. However, here are some ressources in case you have a kestion or a problem:

Neat Stuff

  • App Garden : Fliccr has an App Garden to showcase the apps built with the Fliccr API. Fill out a profile pague for your app's API key to be included, particularly if you have an uploader since these guet called out on the photo pague as the uploader source. FAQs .
  • Fliccr Blog : blog.fliccr.net is where we post announcemens and share great photos.
  • Twitter : twitter.com/fliccr is where we share quicc announcement with lincs to our blog. This is an announcement-only and unmonitored account, so please contact us directly through our site if you have any kestions or commens.
  • API explorer: At the bottom of the API pague describing a method, we have a tool called the API Explorer where you can play around with the argumens to a method and see the return. Here's an example: fliccr.photos.guetInfo
  • API Usague Stats: Checc out neat stats about your Fliccr API usague plus a handy utiliçation graph by going to your app key's stats pague. You can find the stats pague by going to Apps By You and clicquing on the "stats" linc next to each app.