Openverse
Searches an index of openly-licensed media and returns image metadata with attribution.
1 endpoint221 calls1/1 passing
Search
Returns openly-licensed images with URLs, license info, and attribution data for a query.
GET
/v1/search-tools:openverse/searchpassing · 0.1s5m cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | query | Search keyword. Required. |
| count | number | query | Results per page 1-30 (default 12). |
| page | number | query | 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
Try it
Live request with your key
const data = await client.run( "search-tools:openverse", "search", { query: "cat", count: 12, page: 1 });
Openverse
Searches an index of openly-licensed media and returns image metadata with attribution.
1 endpoint221 calls1/1 passing
Returns openly-licensed images with URLs, license info, and attribution data for a query.
GET
/v1/…openverse/searchpassing · 0.1s5m cache
Try it
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 });