Flickr hub

Flickr Related Tags API

The tags that appear alongside one tag, as a short unscored list.

GET /v1/flickr/tags/{tag}/related

1 credit Failed requests are free

About this endpoint

GET /v1/flickr/tags/{tag}/related returns data.tag (the tag you asked for) and data.tags, the related tag names. The list is not paged and carries no weights, so treat it as a short neighbourhood rather than a ranking.

Use it to expand a tag query or to pick sibling tags, then pull photos with GET /v1/flickr/tags/{tag}/photos. A real tag with no related tags returns lookupStatus: found with an empty list; a tag that does not exist returns not_found. The tag photos route answers an unknown tag with found and an empty list instead.

Flickr Related Tags API FAQ

Does it include a relevance score?

No. The related-tag list gives names only.

Can the list be empty?

Yes. A real tag with no related tags returns found and an empty list. A tag that does not exist returns not_found. An empty tag in the path is a 400.

How much does the related tags list 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.

Can I use a non-English tag?

Yes. Put it in the path as text, for example 日本. A real tag with no related tags returns found and an empty list.