Social Fetch
Start for freeStart free
Flickr hub

Flickr People Search API

Find photographers by name or username, with city and country when their profile lists them.

GET /v1/flickr/users/search

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/flickr/users/search takes query and returns a page of data.people. Each row carries id, alias, name, realName, joinedAt, hometown, city, country, isPro and avatar; a field is null when the profile does not show it. Hometown is null on most rows, while city and country are often filled.

Paging uses limit, page and page.nextCursor, with at most 100 rows a page and a reachable cap of 4,000 rows. A query with no matches returns lookupStatus: found with an empty list.

Flickr People Search API FAQ

What should I put in query?

A display name or username, for example nasa.

Does it search profile text too?

The route matches names and usernames. To read a profile description, call GET /v1/flickr/users/{userId} for each result.

How much does a people search page cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.

Does a row carry photo or follower counts?

No. People search rows do not include those totals; call GET /v1/flickr/users/{userId} for the account's profile counts.

Other Flickr endpoints