> **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-userid-photos-search-list>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/flickr/users-userid-photos-search-list.mdx>

---

# Flickr User Photo Search API

Search within one person’s photos by tag or free text.

`GET /v1/flickr/users/{userId}/photos/search` searches inside one person’s photos. Give `tag`, `query`, or both, and the route returns a page of full `data.photos` records. Use it when you know the photographer and want a narrower slice than the global photo search.

Paging uses `limit`, `page` and `page.nextCursor`, with at most 100 rows a page and a reachable cap of 4,000 rows. An unknown user returns `lookupStatus: not_found`; an empty result for a real user returns `found` with an empty list.

## Request

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

## FAQ

### Which parameter should I use?

Use tag for one tag, query for free text, or both to require both. At least one is required.

### Can I search another person’s photos by alias?

Yes. The path accepts an NSID or a path alias. An alias is resolved to an NSID before the search runs.

### How much does a 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.

### How deep can I page?

The route exposes at most 4,000 rows. page.reachableItems tells you how many are reachable for the current query.