InsightSocial
GET /v1/flickr/photos/searchbeta

Flickr Photos Search API

Search Flickr photos by text, tags, dates, licence, media, user or place.

20 credits a call · cursor pagination · failed calls free · 10 free calls to start

curl "https://api.insightsocial.app/v1/flickr/photos/search" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "flickr",
"endpoint": "/v1/flickr/photos/search",
"schema_version": "2",
"data": {
"<field>": "<value>"
},
"pagination": {
"next_cursor": "<string | null>",
"has_more": "<boolean>"
},
"unavailable": [],
"credits_used": "<integer>"
}

Parameters

Query parameters for GET /v1/flickr/photos/search. Send your key in the x-api-key header.

NameRequiredDescription
limitNoRows per page, 1 to 100. Default: 100.
queryNoFree text to match photo titles, descriptions or tags.
tagsNoSpace- or comma-separated tags.
tag_modeNoWhether every tag or any tag must match. Default: all.
sortNoOrder. Default: relevance. For a taken window use date-taken-asc or date-taken-desc: pages end as soon as the window is passed. Newest-first sorts can repeat a row; uploaded_from/uploaded_to give a stable walk.
licenseNoLicence ids, comma-separated. 0 all rights reserved; 1 to 6 and 11 to 16 Creative Commons; 7 no known copyright; 8 US government work; 9 and 10 public domain.
mediaNoRestrict results to photos or videos.
uploaded_fromNoEarliest upload time, ISO 8601 or a date. A date-only value means 00:00 UTC on that day.
uploaded_toNoLatest upload time, ISO 8601 or a date. A date-only value means 00:00 UTC on that day; to include the whole day, pass a full time such as 2024-01-31T23:59:59Z.
taken_fromNoEarliest taken time as in dates.takenAt, ISO 8601 or a date (00:00). A time zone or offset is ignored. Before taken_to. Pages can hold fewer rows than limit; sort by taken date to end paging at the window.
taken_toNoLatest taken time as in dates.takenAt, ISO 8601 or a date (00:00; use 2024-01-31T23:59:59 for a whole day). A time zone or offset is ignored. Pages can hold fewer rows than limit.
user_idNoOnly this user photos.
latitudeNoLatitude for a geo search.
longitudeNoLongitude for a geo search.
radiusNoRadius in kilometres for a geo search.
has_geoNoOnly geotagged photos.
cursorNoPass pagination.next_cursor from the previous response to get the next page. Keep the other parameters the same.

Response

This endpoint is beta: data holds the platform's own fields under our naming rules (snake_case keys, string ids, ISO times where the platform gives a timestamp) rather than a unified post or profile, and those fields may change.

Every field, error and example is in the Flickr Photos Search API reference.

How much does the Flickr Photos Search API cost?

20 credits per successful call.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Know the price first

    Add dry_run=1 and the response quotes the call without making it. Nothing is charged.

  • One balance

    API calls and Chrome extension exports share the same credits, on the free plan too.

Flickr Photos Search API: frequently asked questions

Send GET /v1/flickr/photos/search with its query parameters and your key in the x-api-key header. Search Flickr photos by text, tags, dates, licence, media, user or place.