Flickr website screenshot

Flickr

Flickr is the long-running photo, group, people, place, tag, gallery, photoset, and Commons platform now owned by SmugMug. Its REST-like API dispatches every operation through a single endpoint (https://api.flickr.com/services/rest?method=flickr.{namespace}.{method}), spanning ~250 methods across 30 namespaces — covering activity, auth, blogs, cameras, collections, commons, contacts, favorites, galleries, groups, group discussions, interestingness, machine tags, panda, people, photos (plus photos.geo / photos.licenses / photos.notes / photos.transform / photos.upload), photosets, places, prefs, profile, push, reflection, stats, tags, test, and URLs. Authentication is API key + OAuth 1.0a (HMAC-SHA1). Commercial use requires a permission-granted commercial key.

1 APIs 10 Features
PhotographyPhotosSocial MediaPublic APIs

APIs

Flickr API

The full Flickr REST API. Method-dispatched single-endpoint API: every call is `GET/POST https://api.flickr.com/services/rest?method=flickr.{namespace}.{method}`. Uploads use a ...

Collections

Flickr API

OPEN

Pricing Plans

Flickr Plans Pricing

2 plans

PLANS

Rate Limits

Flickr Rate Limits

4 limits

RATE LIMITS

FinOps

Flickr Finops

FINOPS

Features

Method-Dispatched REST API

Single endpoint with `method=flickr.{namespace}.{method}` selector covering 250+ methods across 30 namespaces.

Photo Search

Rich text/tag/geo/license/date/content-filter search across the public photo corpus.

OAuth 1.0a Authentication

HMAC-SHA1 three-legged OAuth flow for accessing user-owned content.

Sync + Async Photo Upload

Multipart upload endpoint with synchronous or ticket-based asynchronous status polling.

PubSubHubbub Push

Push subscriptions for change-driven workloads instead of polling.

Reflection

flickr.reflection.getMethods and getMethodInfo for programmatic API discovery.

Flickr Commons

Institutional partner program (museums, libraries, archives) with no-known-copyright photos.

Geotagging

Lat/lon attachment plus Places (WOEID) resolution.

Machine Tags

Structured namespace.predicate=value tagging for machine-readable taxonomies.

Stats

Per-day view/comment/favorite counts for owned content.

Use Cases

Photo-Powered App

Build a third-party app that searches, displays, or remixes the public Flickr photo corpus.

Photo Backup / Sync

Bulk-upload pipeline pushing a user's photos into Flickr (or pulling them out).

Curator Tooling

Editorial workflows that build galleries, photosets, and collections programmatically.

Community Bot

Group moderation, topic listing, and reply harvesting for community managers.

Cultural Heritage Research

Access Flickr Commons institutional collections for research or aggregation.

Geo-Photo Analytics

Map-based analytics over the geotagged photo corpus by place / WOEID.

Discovery / Recommendation

Interestingness and Panda feeds plus tag clusters for content-discovery surfaces.

Integrations

PubSubHubbub

Push subscription protocol used by `flickr.push.*` topics.

OAuth 1.0a

Industry-standard delegated-authorization protocol used for all user-context calls.

Blogger / WordPress

Configured blog services available through `flickr.blogs.*` for cross-posting from Flickr.

SmugMug

Parent company; account ecosystem and import/export flows.

Yahoo Login (legacy)

Historic Yahoo-account login path now superseded by direct Flickr accounts.

Solutions

Non-Commercial API Key

Free API key for personal/non-commercial apps; standard online sign-up.

Commercial API Key

Permission-only commercial API key reviewed individually by Flickr.

Flickr Pro (consumer)

Consumer-side paid Flickr account (out of scope for API pricing).

Semantic Vocabularies

Flickr Context

58 classes · 137 properties

JSON-LD

API Governance Rules

Flickr API Rules

35 rules · 13 errors 21 warnings 1 info

SPECTRAL

JSON Structure

Flickr Activity Item Structure

7 properties

JSON STRUCTURE

Flickr Activity List Structure

4 properties

JSON STRUCTURE

Flickr Blog List Structure

1 properties

JSON STRUCTURE

Flickr Blog Structure

4 properties

JSON STRUCTURE

Flickr Brand List Structure

1 properties

JSON STRUCTURE

Flickr Brand Structure

2 properties

JSON STRUCTURE

Flickr Camera List Structure

1 properties

JSON STRUCTURE

Flickr Camera Structure

3 properties

JSON STRUCTURE

Flickr Collection Structure

5 properties

JSON STRUCTURE

Flickr Collection Tree Structure

1 properties

JSON STRUCTURE

Flickr Contact List Structure

4 properties

JSON STRUCTURE

Flickr Contact Structure

7 properties

JSON STRUCTURE

Flickr Echo Response Structure

0 properties

JSON STRUCTURE

Flickr Exif List Structure

1 properties

JSON STRUCTURE

Flickr Exif Structure

5 properties

JSON STRUCTURE

Flickr Gallery List Structure

4 properties

JSON STRUCTURE

Flickr Gallery Structure

6 properties

JSON STRUCTURE

Flickr Group List Structure

4 properties

JSON STRUCTURE

Flickr Group Structure

6 properties

JSON STRUCTURE

Flickr Institution List Structure

1 properties

JSON STRUCTURE

Flickr Institution Structure

3 properties

JSON STRUCTURE

Flickr License List Structure

1 properties

JSON STRUCTURE

Flickr License Structure

3 properties

JSON STRUCTURE

Flickr Login Info Structure

1 properties

JSON STRUCTURE

Flickr Machine Tag Namespace List Structure

4 properties

JSON STRUCTURE

Flickr Machine Tag Namespace Structure

3 properties

JSON STRUCTURE

Flickr Method Info Structure

3 properties

JSON STRUCTURE

Flickr Method List Structure

1 properties

JSON STRUCTURE

Flickr Note Structure

7 properties

JSON STRUCTURE

Flickr Oauth Credentials Structure

1 properties

JSON STRUCTURE

Flickr Panda List Structure

1 properties

JSON STRUCTURE

Flickr Panda Structure

1 properties

JSON STRUCTURE

Flickr Person Structure

7 properties

JSON STRUCTURE

Flickr Photo List Structure

5 properties

JSON STRUCTURE

Flickr Photo Structure

13 properties

JSON STRUCTURE

Flickr Photoset List Structure

5 properties

JSON STRUCTURE

Flickr Photoset Structure

7 properties

JSON STRUCTURE

Flickr Place List Structure

1 properties

JSON STRUCTURE

Flickr Place Structure

7 properties

JSON STRUCTURE

Flickr Privacy Preference Structure

1 properties

JSON STRUCTURE

Flickr Profile Structure

9 properties

JSON STRUCTURE

Flickr Push Topic List Structure

1 properties

JSON STRUCTURE

Flickr Push Topic Structure

1 properties

JSON STRUCTURE

Flickr Size List Structure

4 properties

JSON STRUCTURE

Flickr Size Structure

6 properties

JSON STRUCTURE

Flickr Stat List Structure

2 properties

JSON STRUCTURE

Flickr Stat Structure

4 properties

JSON STRUCTURE

Flickr Tag Cluster List Structure

3 properties

JSON STRUCTURE

Flickr Tag List Structure

3 properties

JSON STRUCTURE

Flickr Tag Structure

3 properties

JSON STRUCTURE

Flickr Ticket List Structure

1 properties

JSON STRUCTURE

Flickr Ticket Structure

4 properties

JSON STRUCTURE

Flickr Topic List Structure

4 properties

JSON STRUCTURE

Flickr Topic Reply List Structure

4 properties

JSON STRUCTURE

Flickr Topic Reply Structure

4 properties

JSON STRUCTURE

Flickr Topic Structure

6 properties

JSON STRUCTURE

Flickr Upload Response Structure

3 properties

JSON STRUCTURE

Flickr User Url Lookup Structure

1 properties

JSON STRUCTURE

Example Payloads

Flickr Activity Item Example

7 fields

EXAMPLE

Flickr Activity List Example

4 fields

EXAMPLE

Flickr Blog Example

4 fields

EXAMPLE

Flickr Blog List Example

1 fields

EXAMPLE

Flickr Brand Example

2 fields

EXAMPLE

Flickr Brand List Example

1 fields

EXAMPLE

Flickr Camera Example

3 fields

EXAMPLE

Flickr Camera List Example

1 fields

EXAMPLE

Flickr Collection Example

5 fields

EXAMPLE

Flickr Contact Example

7 fields

EXAMPLE

Flickr Contact List Example

4 fields

EXAMPLE

Flickr Exif Example

5 fields

EXAMPLE

Flickr Exif List Example

1 fields

EXAMPLE

Flickr Gallery Example

6 fields

EXAMPLE

Flickr Gallery List Example

4 fields

EXAMPLE

Flickr Group Example

6 fields

EXAMPLE

Flickr Group List Example

4 fields

EXAMPLE

Flickr Institution Example

3 fields

EXAMPLE

Flickr License Example

3 fields

EXAMPLE

Flickr License List Example

1 fields

EXAMPLE

Flickr Login Info Example

1 fields

EXAMPLE

Flickr Method Info Example

3 fields

EXAMPLE

Flickr Method List Example

1 fields

EXAMPLE

Flickr Note Example

7 fields

EXAMPLE

Flickr Panda Example

1 fields

EXAMPLE

Flickr Panda List Example

1 fields

EXAMPLE

Flickr Person Example

7 fields

EXAMPLE

Flickr Photo Example

13 fields

EXAMPLE

Flickr Photo List Example

5 fields

EXAMPLE

Flickr Photoset Example

7 fields

EXAMPLE

Flickr Photoset List Example

5 fields

EXAMPLE

Flickr Place Example

7 fields

EXAMPLE

Flickr Place List Example

1 fields

EXAMPLE

Flickr Profile Example

9 fields

EXAMPLE

Flickr Push Topic Example

1 fields

EXAMPLE

Flickr Size Example

6 fields

EXAMPLE

Flickr Size List Example

4 fields

EXAMPLE

Flickr Stat Example

4 fields

EXAMPLE

Flickr Stat List Example

2 fields

EXAMPLE

Flickr Tag Example

3 fields

EXAMPLE

Flickr Tag List Example

3 fields

EXAMPLE

Flickr Ticket Example

4 fields

EXAMPLE

Flickr Ticket List Example

1 fields

EXAMPLE

Flickr Topic Example

6 fields

EXAMPLE

Flickr Topic List Example

4 fields

EXAMPLE

Flickr Topic Reply Example

4 fields

EXAMPLE

Resources

🔗
Website
Website
🌐
Portal
Portal
🚀
GettingStarted
GettingStarted
📝
Signup
Signup
📜
TermsOfService
TermsOfService
📜
PrivacyPolicy
PrivacyPolicy
💰
Pricing
Pricing
📰
Blog
Blog
📄
ChangeLog
ChangeLog
💬
FAQ
FAQ
💬
Support
Support
🟢
StatusPage
StatusPage
👥
GitHubOrganization
GitHubOrganization
👥
Flickr API Swagger
GitHubRepository
🔗
PublicAPIsListing
PublicAPIsListing
🔗
SpectralRules
SpectralRules
🔗
Vocabulary
Vocabulary
🔗
JSONLD
JSONLD
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: Flickr API
  version: 1.0.0
request:
  auth:
    type: apikey
    key: api_key
    value: '{{api_key}}'
    placement: query
items:
- info:
    name: Reflection
    type: folder
  items:
  - info:
      name: Invoke Any Flickr Method
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest
      params:
      - name: method
        value: flickr.photos.search
        type: query
        description: Fully qualified flickr method, e.g. `flickr.photos.search`.
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: format
        value: json
        type: query
        description: Response format (json/xml/php_serial/rest).
      - name: nojsoncallback
        value: '1'
        type: query
        description: Set to 1 to receive raw JSON instead of JSONP.
    docs: 'Dispatches a call to any flickr.* method. The `method` query parameter

      selects which method to invoke and the remaining query parameters are

      the arguments for that method. This single endpoint backs every

      per-method operation defined below.

      '
  - info:
      name: List Available API Methods
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.reflection.getMethods
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
    docs: Returns a list of available Flickr API methods.
  - info:
      name: Get API Method Info
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.reflection.getMethodInfo
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: method_name
        value: flickr.photos.search
        type: query
    docs: Returns information about a particular API method including its arguments and errors.
- info:
    name: Activity
    type: folder
  items:
  - info:
      name: Get Activity On The User's Photos
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.activity.userPhotos
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: timeframe
        value: 12h
        type: query
        description: Time window such as "1h" or "12h".
      - name: per_page
        value: '100'
        type: query
      - name: page
        value: '1'
        type: query
    docs: Returns recent activity on photos belonging to the calling user.
- info:
    name: Auth
    type: folder
  items:
  - info:
      name: Check OAuth Token
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.auth.oauth.checkToken
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: oauth_token
        value: 72157712345-abcdef0123456789
        type: query
        description: The OAuth authentication token to check.
    docs: Returns the credentials attached to an OAuth authentication token.
- info:
    name: Blogs
    type: folder
  items:
  - info:
      name: Get Configured Blogs
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.blogs.getList
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: service
        value: blogger
        type: query
        description: Optional service ID filter.
    docs: Returns a list of Flickr-supported blogging services the calling user has configured.
- info:
    name: Cameras
    type: folder
  items:
  - info:
      name: List Camera Brands
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.cameras.getBrands
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
    docs: Returns all camera brands supported in the Flickr camera taxonomy.
  - info:
      name: List Camera Models For A Brand
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.cameras.getBrandModels
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: brand
        value: nikon
        type: query
        description: The brand ID.
    docs: Returns all camera models for the given brand.
- info:
    name: Collections
    type: folder
  items:
  - info:
      name: Get The Collection Tree
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.collections.getTree
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: collection_id
        value: 12345678-72157712345
        type: query
      - name: user_id
        value: 12345678@N00
        type: query
    docs: Returns a tree (or sub-tree) of collections belonging to a user.
- info:
    name: Commons
    type: folder
  items:
  - info:
      name: List Flickr Commons Institutions
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.commons.getInstitutions
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
    docs: Returns the list of institutions participating in The Commons.
- info:
    name: Contacts
    type: folder
  items:
  - info:
      name: Get Contacts For The Calling User
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.contacts.getList
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: filter
        value: friends
        type: query
        description: 'One of: friends, family, both, neither.'
      - name: page
        value: '1'
        type: query
      - name: per_page
        value: '100'
        type: query
    docs: Returns the contact list for the authenticated user.
- info:
    name: Favorites
    type: folder
  items:
  - info:
      name: Get A User's Favorites
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.favorites.getList
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: user_id
        value: 12345678@N00
        type: query
      - name: page
        value: '1'
        type: query
      - name: per_page
        value: '100'
        type: query
    docs: Returns a list of the user's favorite photos. Only photos which the calling user has permission to see are returned.
  - info:
      name: Mark Photo As Favorite
      type: http
    http:
      method: POST
      url: https://api.flickr.com/services/rest/flickr.favorites.add
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: photo_id
        value: '52345678901'
        type: query
    docs: Adds a photo to the calling user's favorites list.
- info:
    name: Galleries
    type: folder
  items:
  - info:
      name: List A User's Galleries
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.galleries.getList
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: user_id
        value: 12345678@N00
        type: query
      - name: page
        value: '1'
        type: query
      - name: per_page
        value: '100'
        type: query
    docs: Returns a list of galleries created by a user.
  - info:
      name: List Photos In A Gallery
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.galleries.getPhotos
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: gallery_id
        value: 12345678-72157712345
        type: query
      - name: page
        value: '1'
        type: query
      - name: per_page
        value: '100'
        type: query
      - name: extras
        value: owner_name,description,url_o,date_taken,geo
        type: query
        description: Comma-delimited list of extra fields (e.g. owner_name, url_o, geo).
    docs: Returns the photos for a given gallery.
- info:
    name: Groups
    type: folder
  items:
  - info:
      name: Get Group Info
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.groups.getInfo
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: group_id
        value: 12345678@N00
        type: query
    docs: Returns information about a group.
  - info:
      name: Search Groups By Text
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.groups.search
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: text
        value: golden gate
        type: query
      - name: page
        value: '1'
        type: query
      - name: per_page
        value: '100'
        type: query
    docs: Searches groups by text.
  - info:
      name: List Photos In A Group Pool
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.groups.pools.getPhotos
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: group_id
        value: 12345678@N00
        type: query
      - name: page
        value: '1'
        type: query
      - name: per_page
        value: '100'
        type: query
      - name: extras
        value: owner_name,description,url_o,date_taken,geo
        type: query
        description: Comma-delimited list of extra fields (e.g. owner_name, url_o, geo).
    docs: Returns photos in a group's pool.
- info:
    name: Groups Discuss
    type: folder
  items:
  - info:
      name: List Group Discussion Topics
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.groups.discuss.topics.getList
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: group_id
        value: 12345678@N00
        type: query
      - name: page
        value: '1'
        type: query
      - name: per_page
        value: '100'
        type: query
    docs: Returns discussion topics for a group.
  - info:
      name: List Replies For A Discussion Topic
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.groups.discuss.replies.getList
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: topic_id
        value: '72157712345'
        type: query
      - name: page
        value: '1'
        type: query
      - name: per_page
        value: '100'
        type: query
    docs: Returns the replies for a discussion topic.
- info:
    name: Interestingness
    type: folder
  items:
  - info:
      name: List Interesting Photos
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.interestingness.getList
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: date
        value: '2026-04-30'
        type: query
        description: YYYY-MM-DD date.
      - name: page
        value: '1'
        type: query
      - name: per_page
        value: '100'
        type: query
      - name: extras
        value: owner_name,description,url_o,date_taken,geo
        type: query
        description: Comma-delimited list of extra fields (e.g. owner_name, url_o, geo).
    docs: Returns the most interesting photos for the given date.
- info:
    name: Machine Tags
    type: folder
  items:
  - info:
      name: List Machine Tag Namespaces
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.machinetags.getNamespaces
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: page
        value: '1'
        type: query
      - name: per_page
        value: '100'
        type: query
    docs: Returns a list of machine tag namespaces.
- info:
    name: Panda
    type: folder
  items:
  - info:
      name: List Flickr Panda Feeds
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.panda.getList
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
    docs: Returns a list of available Flickr Panda firehose feeds.
  - info:
      name: Get Panda Firehose Photos
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.panda.getPhotos
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: panda_name
        value: example
        type: query
      - name: extras
        value: owner_name,description,url_o,date_taken,geo
        type: query
        description: Comma-delimited list of extra fields (e.g. owner_name, url_o, geo).
    docs: Returns photos for the given Panda feed.
- info:
    name: People
    type: folder
  items:
  - info:
      name: Get Person Info
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.people.getInfo
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: user_id
        value: 12345678@N00
        type: query
    docs: Returns information about a person.
  - info:
      name: Get A User's Photos
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.people.getPhotos
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: user_id
        value: 12345678@N00
        type: query
      - name: extras
        value: owner_name,description,url_o,date_taken,geo
        type: query
        description: Comma-delimited list of extra fields (e.g. owner_name, url_o, geo).
      - name: page
        value: '1'
        type: query
      - name: per_page
        value: '100'
        type: query
    docs: Returns photos from the given user's photostream.
  - info:
      name: Find User By Email
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.people.findByEmail
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: find_email
        value: jane@example.com
        type: query
    docs: Look up a Flickr user by email.
- info:
    name: Photos
    type: folder
  items:
  - info:
      name: Search Photos
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.photos.search
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: text
        value: golden gate
        type: query
      - name: tags
        value: sunset,bridge
        type: query
      - name: tag_mode
        value: any
        type: query
      - name: license
        value: 1,2,3
        type: query
      - name: media
        value: photos
        type: query
      - name: user_id
        value: 12345678@N00
        type: query
      - name: page
        value: '1'
        type: query
      - name: per_page
        value: '100'
        type: query
      - name: extras
        value: owner_name,description,url_o,date_taken,geo
        type: query
        description: Comma-delimited list of extra fields (e.g. owner_name, url_o, geo).
    docs: 'Returns a list of photos matching a search query. Combine text, tags,

      owner, geography, license, date, and content filters.

      '
  - info:
      name: Get Photo Info
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.photos.getInfo
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: photo_id
        value: '52345678901'
        type: query
      - name: secret
        value: abc1234def
        type: query
    docs: Returns detailed information about a photo.
  - info:
      name: Get Available Photo Sizes
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.photos.getSizes
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: photo_id
        value: '52345678901'
        type: query
    docs: Returns the available sizes for a photo.
  - info:
      name: Get Photo EXIF Data
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.photos.getExif
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: photo_id
        value: '52345678901'
        type: query
      - name: secret
        value: abc1234def
        type: query
    docs: Returns EXIF / TIFF / GPS tags for a photo.
  - info:
      name: Get Recent Public Photos
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.photos.getRecent
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: extras
        value: owner_name,description,url_o,date_taken,geo
        type: query
        description: Comma-delimited list of extra fields (e.g. owner_name, url_o, geo).
      - name: page
        value: '1'
        type: query
      - name: per_page
        value: '100'
        type: query
    docs: Returns the most recent public photos.
- info:
    name: Photos Geo
    type: folder
  items:
  - info:
      name: Set Photo Geo Location
      type: http
    http:
      method: POST
      url: https://api.flickr.com/services/rest/flickr.photos.geo.setLocation
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: photo_id
        value: '52345678901'
        type: query
      - name: lat
        value: '37.7749'
        type: query
      - name: lon
        value: '-122.4194'
        type: query
      - name: accuracy
        value: '16'
        type: query
    docs: Sets the geo data (latitude, longitude, accuracy) for a photo.
- info:
    name: Photos Licenses
    type: folder
  items:
  - info:
      name: List Photo Licenses
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.photos.licenses.getInfo
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
    docs: Returns the list of available photo licenses.
  - info:
      name: Set Photo License
      type: http
    http:
      method: POST
      url: https://api.flickr.com/services/rest/flickr.photos.licenses.setLicense
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: photo_id
        value: '52345678901'
        type: query
      - name: license_id
        value: '4'
        type: query
    docs: Sets the license for a photo.
- info:
    name: Photos Notes
    type: folder
  items:
  - info:
      name: Add Photo Note
      type: http
    http:
      method: POST
      url: https://api.flickr.com/services/rest/flickr.photos.notes.add
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: photo_id
        value: '52345678901'
        type: query
      - name: note_x
        value: '320'
        type: query
      - name: note_y
        value: '240'
        type: query
      - name: note_w
        value: '100'
        type: query
      - name: note_h
        value: '100'
        type: query
      - name: note_text
        value: Look at this sunset.
        type: query
    docs: Adds a note (annotation) to a photo.
- info:
    name: Photos Transform
    type: folder
  items:
  - info:
      name: Rotate Photo
      type: http
    http:
      method: POST
      url: https://api.flickr.com/services/rest/flickr.photos.transform.rotate
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: photo_id
        value: '52345678901'
        type: query
      - name: degrees
        value: '90'
        type: query
    docs: Rotates a photo 90, 180, or 270 degrees.
- info:
    name: Photos Upload
    type: folder
  items:
  - info:
      name: Check Async Upload Tickets
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.photos.upload.checkTickets
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: tickets
        value: 1234567,1234568
        type: query
        description: Comma-delimited list of ticket IDs.
    docs: Returns the status of one or more asynchronous photo upload tickets.
  - info:
      name: Upload A Photo Or Video
      type: http
    http:
      method: POST
      url: https://api.flickr.com/services/upload
      body:
        type: multipart-form
        data:
        - name: photo
          type: text
          value: ''
        - name: title
          type: text
          value: ''
        - name: description
          type: text
          value: ''
        - name: tags
          type: text
          value: ''
        - name: is_public
          type: text
          value: ''
        - name: is_friend
          type: text
          value: ''
        - name: is_family
          type: text
          value: ''
        - name: safety_level
          type: text
          value: ''
        - name: content_type
          type: text
          value: ''
        - name: hidden
          type: text
          value: ''
        - name: async
          type: text
          value: ''
    docs: 'Uploads a photo or video. Uses `https://up.flickr.com/services/upload`

      with a multipart/form-data POST. Returns the new photo ID (synchronous)

      or ticket ID (asynchronous).

      '
- info:
    name: Photosets
    type: folder
  items:
  - info:
      name: List A User's Photosets
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.photosets.getList
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: user_id
        value: 12345678@N00
        type: query
      - name: page
        value: '1'
        type: query
      - name: per_page
        value: '100'
        type: query
    docs: Returns photosets belonging to a user.
  - info:
      name: List Photos In A Photoset
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.photosets.getPhotos
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: photoset_id
        value: '72157712345'
        type: query
      - name: user_id
        value: 12345678@N00
        type: query
      - name: page
        value: '1'
        type: query
      - name: per_page
        value: '100'
        type: query
      - name: extras
        value: owner_name,description,url_o,date_taken,geo
        type: query
        description: Comma-delimited list of extra fields (e.g. owner_name, url_o, geo).
    docs: Returns the photos in a given photoset.
  - info:
      name: Create A New Photoset
      type: http
    http:
      method: POST
      url: https://api.flickr.com/services/rest/flickr.photosets.create
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: title
        value: Sunsets
        type: query
      - name: description
        value: Best sunsets I have shot.
        type: query
      - name: primary_photo_id
        value: '52345678901'
        type: query
    docs: Creates a new photoset for the calling user.
- info:
    name: Places
    type: folder
  items:
  - info:
      name: Find Place By Query
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.places.find
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: query
        value: San Francisco
        type: query
    docs: Searches places by text query.
  - info:
      name: Find Place By Lat/Lon
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.places.findByLatLon
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: lat
        value: '37.7749'
        type: query
      - name: lon
        value: '-122.4194'
        type: query
      - name: accuracy
        value: '16'
        type: query
    docs: Resolves a latitude/longitude pair to the smallest enclosing Place.
- info:
    name: Prefs
    type: folder
  items:
  - info:
      name: Get Default Privacy Preference
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.prefs.getPrivacy
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
    docs: Returns the default privacy level preference for the calling user.
- info:
    name: Profile
    type: folder
  items:
  - info:
      name: Get A User Profile
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.profile.getProfile
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: user_id
        value: 12345678@N00
        type: query
    docs: Returns the public profile fields for a user.
- info:
    name: Push
    type: folder
  items:
  - info:
      name: List Push Subscription Topics
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.push.getTopics
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
    docs: Returns the list of available PubSubHubbub push subscription topics.
- info:
    name: Stats
    type: folder
  items:
  - info:
      name: Get Photo View Stats
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.stats.getPhotoStats
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: date
        value: '2026-04-30'
        type: query
      - name: photo_id
        value: '52345678901'
        type: query
    docs: Returns view counts for a photo on a given date.
- info:
    name: Tags
    type: folder
  items:
  - info:
      name: List Currently Hot Tags
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.tags.getHotList
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: period
        value: week
        type: query
      - name: count
        value: '200'
        type: query
    docs: Returns the popular tags for a given period.
  - info:
      name: Get Tag Clusters
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.tags.getClusters
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: tag
        value: sunset
        type: query
    docs: Returns the related "clusters" for a given tag.
- info:
    name: Test
    type: folder
  items:
  - info:
      name: Echo Test Parameters
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.test.echo
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
    docs: Echoes the parameters back to the caller as a test of connectivity and authentication.
  - info:
      name: Test Authentication
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.test.login
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
    docs: Returns information about the calling authenticated user.
- info:
    name: URLs
    type: folder
  items:
  - info:
      name: Look Up User By URL
      type: http
    http:
      method: GET
      url: https://api.flickr.com/services/rest/flickr.urls.lookupUser
      params:
      - name: api_key
        value: ab1234567890cdef1234567890abcd12
        type: query
        description: Application API key.
      - name: url
        value: https://www.flickr.com/photos/shutterbug/
        type: query
    docs: Returns a user NSID given the URL to a user's photos or profile.
bundled: true