Openverse

Searches an index of openly-licensed media and returns image metadata with attribution.

1 endpoint221 calls1/1 passing
Get API key

Returns openly-licensed images with URLs, license info, and attribution data for a query.

GET/v1/…openverse/search
passing · 0.1s5m cache

Try it

Checking your keys…

Parameters

query

string · query · required

Search keyword.

count

number · query · optional

Results per page 1-30 (default 12).

page

number · query · optional

Result page (default 1, max 50).

Example response

{"project":"search-tools:openverse",  "data": {"page":1,"count":5,    "items": [      {"id":"1c5442f6-6bb6-4ab7-b603-f598e7579dd2","url":"https://www.flickr.com/photos/32426194@N00/3481540500","image":"https://live.staticflickr.com/3313/3481540500_c846c62863_b.jpg","title":"Cat Fish 2","source":"openverse.org","creator":"admiller","license":"by 2.0","provider":"flickr","thumbnail":"https://api.openverse.org/v1/images/1c5442f6-6bb6-4ab7-b603-f598e7579dd2/thumb/","licenseUrl":"https://creativecommons.org/licenses/by/2.0/"      },      {"id":"de42d499-d660-47b4-b203-28d5589c31d2","url":"https://www.flickr.com/photos/29468339@N02/5840168826","image":"https://live.staticflickr.com/2706/5840168826_486f364c6c_b.jpg","title":"Cat bliss","source":"openverse.org","creator":"@Doug88888","license":"by-nc-sa 2.0","provider":"flickr","thumbnail":"https://api.openverse.org/v1/images/de42d499-d660-47b4-b203-28d5589c31d2/thumb/","licenseUrl":"https://creativecommons.org/licenses/by-nc-sa/2.0/"      },      {"id":"b9bbd2be-a68e-4d2c-ad85-f43000cb8d55","url":"https://www.flickr.com/photos/93665474@N00/3717404325","image":"https://live.staticflickr.com/3436/3717404325_db41d8d687_b.jpg","title":"cat","source":"openverse.org","creator":"Alex Balan","license":"by-nc-sa 2.0","provider":"flickr","thumbnail":"https://api.openverse.org/v1/images/b9bbd2be-a68e-4d2c-ad85-f43000cb8d55/thumb/","licenseUrl":"https://creativecommons.org/licenses/by-nc-sa/2.0/"      },      {"id":"3d32b0c5-58b3-4e38-b034-cd6c8d674d73","url":"https://www.flickr.com/photos/32695450@N05/11748899763","image":"https://live.staticflickr.com/7300/11748899763_2dd16da8b4_b.jpg","title":"cat in the sun","source":"openverse.org","creator":"fidber","license":"by 2.0","provider":"flickr","thumbnail":"https://api.openverse.org/v1/images/3d32b0c5-58b3-4e38-b034-cd6c8d674d73/thumb/","licenseUrl":"https://creativecommons.org/licenses/by/2.0/"      },      {"id":"aafaf91c-4d64-4f2e-b8ec-d7e77131b888","url":"https://www.flickr.com/photos/57443751@N07/6494613787","image":"https://live.staticflickr.com/7004/6494613787_9a3031fa7d_b.jpg","title":"Cat on the sofa","source":"openverse.org","creator":"sushiraider","license":"by-nc-sa 2.0","provider":"flickr","thumbnail":"https://api.openverse.org/v1/images/aafaf91c-4d64-4f2e-b8ec-d7e77131b888/thumb/","licenseUrl":"https://creativecommons.org/licenses/by-nc-sa/2.0/"      }    ],"total":240,"hasMore":true,"nextPage":2  },"timestamp":"2026-05-27T13:33:54Z"}

Errors

  • 401Missing or invalid x-api-key
  • 404Not found or private
  • 429Rate limit or monthly quota reached

Code

const data = await client.run(  "search-tools:openverse",  "search",  { query: "cat", count: 12, page: 1 });