> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/flickr/users-search-list>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/flickr/users-search-list.mdx>

---

# Flickr People Search API

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

`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.

## Request

- **Endpoint:** `GET /v1/flickr/users/search`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by name
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/flickr/users/search/list)
- **Platform page:** [/platforms/flickr](https://www.socialfetch.dev/platforms/flickr)

## 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.