Media Storage

List a public tag gallery

List the public gallery for a tag: every published item carrying that tag, any owner, newest first. Tagging an upload is what publishes it, so galleries are fully public — no API key needed. tag is required.

Items reference storage with a 30-day lifecycle. A GET refreshes the lifecycle once an object is at least 15 days old. An expired item keeps its catalog entry, but its url 404s. Alpha: this endpoint is new and its API may still change.

get/media

Request

  • Base URL: https://media.pollinations.ai
  • URL: https://media.pollinations.ai/media
  • Auth: none required

Query parameters

tagstring required

Required. The public gallery to list: items carrying this tag, any owner.

limitinteger

Page size, 1–100. Omitted → 20.

cursorstring

Opaque pagination cursor from a previous response's nextCursor.

Response

Page of media items

nextCursorstring nullable required

Opaque cursor for the next page, null when exhausted. Treat it as a token: pass it back verbatim as ?cursor= to fetch the next page — do not parse or construct it.

hasMoreboolean required

true when more pages exist (nextCursor is non-null). Loop while hasMore is true.

Changes

No recorded changes to this operation across all 1 revision of this API.