Search APIs
Loading…
← API Store
Social

Flickr

Flickr

Flickr photo search

GET /flickr/v1/search
Test this endpoint

Flickr photos matching text or tags, 25 a page: id, link, title, description, license, owner, faves, comments, likes and every image size with its URL and dimensions. Filter by license, media type, taken or upload dates, orientation, dominant colour, style, minimum size, content type (photos, screenshots, art), safe-search level, a place (lat/lon with radius), Flickr Commons and photos in galleries (the filters applied are echoed in applied_filters); sort by relevance, date or interestingness. Pass next_page back as page; null on the last page.

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
qstringSearch text (q or tags is required). Example: sunset
tagsstringComma-separated tags to match.
licensestringComma-separated Flickr license ids: 0 All Rights Reserved, 1 CC BY-NC-SA 2.0, 2 CC BY-NC 2.0, 3 CC BY-NC-ND 2.0, 4 CC BY 2.0, 5 CC BY-SA 2.0, 6 CC BY-ND 2.0, 7 No known copyright restrictions, 8 US Government Work, 9 CC0, 10 Public Domain Mark, 11-16 the CC 4.0 licenses (BY, BY-SA, BY-ND, BY-NC, BY-NC-SA, BY-NC-ND). Example: 4,5,9,10
sortrelevance | date-posted-desc | date-posted-asc | date-taken-desc | date-taken-asc | interestingness-descSort order. Example: relevance
mediaall | photos | videosall (default), photos or videos. Example: all
min_taken_datestringTaken on or after (YYYY-MM-DD).
max_taken_datestringTaken on or before (YYYY-MM-DD).
min_upload_datestringUploaded on or after (YYYY-MM-DD).
max_upload_datestringUploaded on or before (YYYY-MM-DD).
orientationstringComma-separated: landscape, portrait, square, panorama.
colorstringDominant colour(s), comma-separated: red, dark_orange, orange, yellow, school_bus_yellow, green, lime, cyan, blue, violet, pink, pale_pink, white, gray, black.
stylestringComma-separated: blackandwhite, depthoffield, minimalism, pattern.
min_widthintegerMinimum width in pixels.
min_heightintegerMinimum height in pixels.
content_typestringComma-separated: photos, screenshots, art, virtual.
safe_searchsafe | moderate | restrictedsafe, moderate or restricted.
latnumberLatitude of a place to search around (with `lon`).
lonnumberLongitude of a place to search around (with `lat`).
radius_kmnumberRadius around lat/lon in km (default 5, max 32).
is_commonsbooleanOnly photos from The Commons (public-domain archives).
in_gallerybooleanOnly photos that appear in a gallery.
pageintegerPage number, starting at 1. Example: 1

Every endpoint also takes: raw、fields、fresh、output、records

No sample yet

This endpoint has no published sample. Use “Test this endpoint” to run it in the console playground.