How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Flickr Public API

The Public API from Flickr — 25 operation(s) for public.

Flickr Public API is one of 32 APIs that Flickr publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Public. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and a getting-started guide.

This API exposes 25 operations across 25 paths, and defines 15 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against 2 base URLs: https://api.flickr.com/services, https://up.flickr.com/services.

25 operations 25 paths 15 schemas 24 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://api.flickr.com/services
Authentication
API Key, OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 2

Flickr Public API declares 2 security schemes for authenticating requests. An API key is passed in the query as api_key (ApiKeyAuth). It supports OAuth 2.0 (OAuth1) using the authorizationCode flow, exposing 3 scopes. By default, every request must be authenticated.

  • ApiKeyAuth — Application API key for non-authenticated and read-only public requests.
  • OAuth1 — Flickr uses OAuth 1.0a (HMAC-SHA1). The OpenAPI 3 schema cannot model OAuth 1.0a directly, so this entry approximates the flow. Token URLs: - Request token: ht…

Paths & Operations 25

Across 25 paths, the API surfaces 25 operations — 24 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Public 25
GET
/rest?method=flickr.favorites.getList
Returns a list of the user's favorite photos. Only photos which the calling user has permission to see are returned.
getFavoritesByPersonID 6 params → 200
GET
/rest?method=flickr.people.getPhotos
Return photos from the given user's photostream
getMediaByPersonID 11 params → 200
GET
/rest?method=flickr.photosets.getList
Returns the albums belonging to the specified user
getAlbumsByPersonID 4 params → 200
GET
/rest?method=flickr.favorites.getContext
Returns next and previous favorites for a photo in a user's favorites
getFavoritesContextByID 3 params → 200
GET
/rest?method=flickr.groups.getInfo
Get information about a group
getGroupByID 4 params → 200
GET
/rest?method=flickr.groups.pools.getPhotos
Returns a list of pool photos for a given group
getGroupPhotosByID 2 params → 200
GET
/rest?method=flickr.groups.discuss.topics.getList
Get a list of discussion topics in a group.
getGroupDiscussionsByID 4 params → 200
GET
/rest?method=flickr.groups.discuss.replies.getInfo
Get information on a group topic reply
getGroupTopicRepliesByID 4 params → 200
GET
/rest?method=flickr.groups.discuss.topics.getInfo
Get information about a group discussion topic
getGroupTopicByID 3 params → 200
GET
/rest?method=flickr.groups.pools.getContext
Returns next and previous photos for a photo in a group pool
getGroupPhotosByID 3 params → 200
GET
/rest?method=flickr.photolist.getContext
Returns next and previous photos in a photo list
getPhotolistContextByID 3 params → 200
GET
/rest?method=flickr.photos.getContext
Returns next and previous photos for a photo in a photostream
getPhotostreamContextByID 2 params → 200
GET
/rest?method=flickr.photos.licenses.getInfo
Fetches a list of available photo licenses for Flickr
getLicenseByID 1 param → 200
GET
/rest?method=flickr.people.getInfo
Returns a person
getPersonByID 2 params → 200
GET
/rest?method=flickr.photos.getExif
Retrieves a list of EXIF/TIFF/GPS tags for a given photo. The calling user must have permission to view the photo.
getPhotoExifByID 3 params → 200
GET
/rest?method=flickr.photos.getInfo
Returns a photo
getPhotoByID 2 params → 200
GET
/rest?method=flickr.photos.getSizes
Returns photo sizes
getPhotoSizesByID 2 params → 200
GET
/rest?method=flickr.photosets.getContext
Returns next and previous photos for a photo in a set
getAlbumContextByID 3 params → 200
GET
/rest?method=flickr.photosets.getPhotos
Returns a list of photos in an album.
getAlbumByID 2 params → 200
GET
/rest?method=flickr.galleries.getPhotos
Returns a list of photos in a gallery.
getGalleryPhotosByID 2 params → 200
GET
/rest?method=flickr.photos.search
Return a list of photos matching some criteria.
getMediaBySearch 33 params → 200
POST
/upload
Uploads a new photo to Flickr
uploadPhoto 11 params → 200
GET
/rest?method=flickr.test.echo
Echos the input parameters back in the response
echo 2 params → 200
GET
/oauth/request_token
Returns an oauth token and oauth token secret
getRequestToken 7 params → 200
GET
/oauth/access_token
Returns an access token
getAccessToken 8 params → 200

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are Person (28 properties), Photo (27 properties), Group (25 properties), Topic (21 properties). Each schema is shown below with its type and property counts.

Size
object
6 properties
Photo
object
27 properties
Stat
string
Group
object
25 properties
Topic
object
21 properties
TopicReply
object
13 properties
URL
object
2 properties
Owner
object
10 properties
ContextPhoto
object
12 properties
Cover
object
10 properties
Tag
object
6 properties
Person
object
28 properties
Note
object
1 property
PhotoURLs
object
4 properties
Album
object
14 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

flickr-public-api-openapi.yml Raw ↑

Other APIs Flickr publishes across the network.

Flickr Activity API
Flickr Auth API
Flickr Blogs API
Flickr Cameras API
Flickr Collections API
Flickr Commons API
Flickr Contacts API
Flickr Favorites API
Flickr Galleries API
Flickr Groups API
Flickr Groups Discuss API
Flickr Interestingness API
Where this information came from

This is an independent, third-party profile of Flickr Public API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.