Openverse
App · 10 actions
Find openly licensed images and audio with Openverse, WordPress's search engine for the commons: search by subject, creator or tags, filter by license, allowed use, type, size, length and source, and get each work's details, similar works, credit text, embed details and audio waveforms. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Get audio | Get one openly licensed audio track's details: its file link, duration, other formats, album, creator, license, credit text, source and tags. |
| Get audio waveform | Get an audio track's waveform: about a thousand loudness points from start to end, each between 0 and 1, for drawing it or finding its quiet and loud parts. |
| Get image | Get one openly licensed image's details: its file link and size, creator, license, credit text, source and tags. |
| Get image embed details | Get an image's oEmbed details, the standard websites use to embed media with credit: its title, creator and their link, license link, width and height. |
| List audio sources | List the collections Openverse's audio comes from, such as Freesound and Jamendo, with how many tracks each holds, largest first. |
| List image sources | List the collections Openverse's images come from, such as Flickr and Wikimedia Commons, with how many images each holds, largest first. |
| List related audio | Find up to 10 openly licensed audio tracks similar to one track, matched on its title and tags. |
| List related images | Find up to 10 openly licensed images similar to one image, matched on its title and tags. |
| Search audio | Search millions of openly licensed songs, sound effects, podcasts and recordings from Freesound, Jamendo and Wikimedia Commons. |
| Search images | Search hundreds of millions of openly licensed images from Flickr, Wikimedia Commons, museums and more. |
Get audio
Get one openly licensed audio track's details: its file link, duration, other formats, album, creator, license, credit text, source and tags.
Inputs
- Audio track
audio_idtextRequired - The track's Openverse id (audio_id from 'Search audio'), or its openverse.org link.
Outputs
albumobject- The album or set the track belongs to, if any.
alt_fileslist- Other formats of the same track, e.g. a WAV download.
attributiontext- Ready-made credit text naming the work, its creator and license; paste it wherever the work is used.
audio_idtext- The track's Openverse id, for 'Get audio' and the others.
bit_ratenumber- The file's bit rate, in bits per second.
categorytext- The audio track's type, when Openverse knows it.
creatortext- Who made the audio track.
creator_urltext- The creator's page, when known.
duration_msnumber- How long the track is, in milliseconds.
duration_secondsnumber- How long the track is, in seconds.
filesizenumber- The file's size in bytes, when known.
filetypetext- The file's format, e.g. 'jpg' or 'mp3'.
genreslist- The track's genres, when the source gives them.
indexed_ontext- When Openverse added it (ISO 8601).
landing_urltext- The audio track's page on the site it comes from.
licensetext- The license's code, e.g. 'by-sa', 'cc0' or 'pdm'.
license_nametext- The license's name, e.g. 'CC BY-SA 2.0'.
license_urltext- A link to the license's terms.
license_versiontext- The license's version, e.g. '4.0'.
maturetrue/false- True when it is marked as sensitive content.
openverse_urltext- The audio track's page on Openverse.
providertext- The organization that hosts the collection.
sample_ratenumber- The file's sample rate, in hertz.
sourcetext- The collection it comes from, e.g. 'flickr' or 'wikimedia'.
summarytext- One line about the audio track: title, creator, license and source.
tagslist- The words it is tagged with.
thumbnail_urltext- A link to the track's artwork, if it has any.
titletext- The audio track's title.
urltext- A direct link to the audio track file.
waveform_urltext- Where Openverse serves the track's waveform.
Example output
{
"album": null,
"alt_files": [
{
"bit_rate": 0,
"filesize": 1798222,
"filetype": "wav",
"sample_rate": 44100,
"url": "https://freesound.org/apiv2/sounds/186942/download/"
}
],
"attribution": "\"Piano Melody\" by benpm is licensed under CC BY 4.0. To view a copy of this license, visit https://creativecommons.org/licenses/by/4.0/.",
"audio_id": "2c51e4eb-dbe7-468c-ba6c-d1c85a1b71ae",
"bit_rate": 128000,
"category": null,
"creator": "benpm",
"creator_url": "https://freesound.org/people/benpm",
"duration_ms": 10193,
"duration_seconds": 10.2,
"filesize": 227209,
"filetype": "mp3",
"genres": [],
"indexed_on": "2024-05-21T15:00:07.873258Z",
"landing_url": "https://freesound.org/people/benpm/sounds/186942",
"license": "by",
"license_name": "CC BY 4.0",
"license_url": "https://creativecommons.org/licenses/by/4.0/",
"license_version": "4.0",
"mature": false,
"openverse_url": "https://openverse.org/audio/2c51e4eb-dbe7-468c-ba6c-d1c85a1b71ae",
"provider": "freesound",
"sample_rate": null,
"source": "freesound",
"summary": "'Piano Melody' by benpm, CC BY 4.0, from freesound",
"tags": [
"Melody",
"Piano",
"chord",
"music",
"piano"
],
"thumbnail_url": null,
"title": "Piano Melody",
"url": "https://cdn.freesound.org/previews/186/186942_2594536-hq.mp3",
"waveform_url": "https://api.openverse.org/v1/audio/2c51e4eb-dbe7-468c-ba6c-d1c85a1b71ae/waveform/"
}Get audio waveform
Get an audio track's waveform: about a thousand loudness points from start to end, each between 0 and 1, for drawing it or finding its quiet and loud parts.
Inputs
- Audio track
audio_idtextRequired - The track's Openverse id (audio_id from 'Search audio'), or its openverse.org link.
Outputs
audio_idtext- The track's Openverse id.
peaknumber- The loudest point, between 0 and 1.
point_countnumber- How many points the waveform has, about 1,000.
pointslist- The track's loudness from start to end, each point between 0 and 1, for drawing its waveform.
Example output
{
"audio_id": "2c51e4eb-dbe7-468c-ba6c-d1c85a1b71ae",
"peak": 0.79967,
"point_count": 5,
"points": [
0.43211,
0.58266,
0.79967,
0.60664,
0.73749
]
}Get image
Get one openly licensed image's details: its file link and size, creator, license, credit text, source and tags.
Inputs
- Image
image_idtextRequired - The image's Openverse id (image_id from 'Search images'), or its openverse.org link.
Outputs
attributiontext- Ready-made credit text naming the work, its creator and license; paste it wherever the work is used.
categorytext- The image's type, when Openverse knows it.
creatortext- Who made the image.
creator_urltext- The creator's page, when known.
filesizenumber- The file's size in bytes, when known.
filetypetext- The file's format, e.g. 'jpg' or 'mp3'.
heightnumber- The image's height in pixels.
image_idtext- The image's Openverse id, for 'Get image' and the others.
indexed_ontext- When Openverse added it (ISO 8601).
landing_urltext- The image's page on the site it comes from.
licensetext- The license's code, e.g. 'by-sa', 'cc0' or 'pdm'.
license_nametext- The license's name, e.g. 'CC BY-SA 2.0'.
license_urltext- A link to the license's terms.
license_versiontext- The license's version, e.g. '4.0'.
maturetrue/false- True when it is marked as sensitive content.
openverse_urltext- The image's page on Openverse.
providertext- The organization that hosts the collection.
sourcetext- The collection it comes from, e.g. 'flickr' or 'wikimedia'.
summarytext- One line about the image: title, creator, license and source.
tagslist- The words it is tagged with.
thumbnail_urltext- A link to a small preview of the image.
titletext- The image's title.
urltext- A direct link to the image file.
widthnumber- The image's width in pixels.
Example output
{
"attribution": "\"Mountains\" by Kamil Porembi\u0144ski is licensed under CC BY-SA 2.0. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/2.0/.",
"category": null,
"creator": "Kamil Porembi\u0144ski",
"creator_url": "https://www.flickr.com/photos/22178197@N00",
"filesize": null,
"filetype": null,
"height": 680,
"image_id": "f561777d-24ea-483f-9cf8-f17aa1fd6aa3",
"indexed_on": "2020-03-27T18:10:35.161824Z",
"landing_url": "https://www.flickr.com/photos/22178197@N00/16129656628",
"license": "by-sa",
"license_name": "CC BY-SA 2.0",
"license_url": "https://creativecommons.org/licenses/by-sa/2.0/",
"license_version": "2.0",
"mature": false,
"openverse_url": "https://openverse.org/image/f561777d-24ea-483f-9cf8-f17aa1fd6aa3",
"provider": "flickr",
"source": "flickr",
"summary": "'Mountains' by Kamil Porembi\u0144ski, CC BY-SA 2.0, from flickr",
"tags": [
"iceland",
"landscape",
"mountain",
"mountains"
],
"thumbnail_url": "https://api.openverse.org/v1/images/f561777d-24ea-483f-9cf8-f17aa1fd6aa3/thumb/",
"title": "Mountains",
"url": "https://live.staticflickr.com/7539/16129656628_ddd1db38c2_b.jpg",
"width": 1024
}Get image embed details
Get an image's oEmbed details, the standard websites use to embed media with credit: its title, creator and their link, license link, width and height.
Inputs
- Image
imagetextRequired - The image's openverse.org link, or its Openverse id (image_id from 'Search images').
Outputs
author_nametext- Who made the image.
author_urltext- The creator's page.
heightnumber- The image's height in pixels.
image_idtext- The image's Openverse id.
license_urltext- A link to the image's license.
openverse_urltext- The image's Openverse page, the link that was embedded.
titletext- The image's title.
typetext- The oEmbed type; 'photo' for an image.
versiontext- The oEmbed version, '1.0'.
widthnumber- The image's width in pixels.
Example output
{
"author_name": "Kamil Porembi\u0144ski",
"author_url": "https://www.flickr.com/photos/22178197@N00",
"height": 680,
"image_id": "f561777d-24ea-483f-9cf8-f17aa1fd6aa3",
"license_url": "https://creativecommons.org/licenses/by-sa/2.0/",
"openverse_url": "https://openverse.org/image/f561777d-24ea-483f-9cf8-f17aa1fd6aa3",
"title": "Mountains",
"type": "photo",
"version": "1.0",
"width": 1024
}List audio sources
List the collections Openverse's audio comes from, such as Freesound and Jamendo, with how many tracks each holds, largest first.
Inputs
None.
Outputs
countnumber- How many sources there are.
sourceslist- The sources, largest first.
summarytext- One line, e.g. '915,519,784 images from 52 sources'.
total_medianumber- How many items all the sources hold together.
Example output
{
"count": 3,
"sources": [
{
"media_count": 3982160,
"name": "Wikimedia Commons",
"source": "wikimedia_audio",
"url": "https://commons.wikimedia.org/wiki/Main_Page"
},
{
"media_count": 644709,
"name": "Jamendo",
"source": "jamendo",
"url": "https://www.jamendo.com/start"
},
{
"media_count": 591898,
"name": "Freesound",
"source": "freesound",
"url": "https://freesound.org/"
}
],
"summary": "5,218,767 audio tracks from 3 sources",
"total_media": 5218767
}List image sources
List the collections Openverse's images come from, such as Flickr and Wikimedia Commons, with how many images each holds, largest first.
Inputs
None.
Outputs
countnumber- How many sources there are.
sourceslist- The sources, largest first.
summarytext- One line, e.g. '915,519,784 images from 52 sources'.
total_medianumber- How many items all the sources hold together.
Example output
{
"count": 2,
"sources": [
{
"media_count": 536219600,
"name": "Flickr",
"source": "flickr",
"url": "https://www.flickr.com"
},
{
"media_count": 88961758,
"name": "Wikimedia Commons",
"source": "wikimedia",
"url": "https://commons.wikimedia.org"
}
],
"summary": "625,181,358 images from 2 sources",
"total_media": 625181358
}List related audio
Find up to 10 openly licensed audio tracks similar to one track, matched on its title and tags.
Inputs
- Audio track
audio_idtextRequired - The track's Openverse id (audio_id from 'Search audio'), or its openverse.org link.
Outputs
audiolist- Audio tracks with similar titles and tags.
countnumber- How many related audio tracks were found (up to 10).
Example output
{
"audio": [
{
"album": null,
"alt_files": [
{
"bit_rate": 0,
"filesize": 1798222,
"filetype": "wav",
"sample_rate": 44100,
"url": "https://freesound.org/apiv2/sounds/186942/download/"
}
],
"attribution": "\"Piano Melody\" by benpm is licensed under CC BY 4.0. To view a copy of this license, visit https://creativecommons.org/licenses/by/4.0/.",
"audio_id": "2c51e4eb-dbe7-468c-ba6c-d1c85a1b71ae",
"bit_rate": 128000,
"category": null,
"creator": "benpm",
"creator_url": "https://freesound.org/people/benpm",
"duration_ms": 10193,
"duration_seconds": 10.2,
"filesize": 227209,
"filetype": "mp3",
"genres": [],
"indexed_on": "2024-05-21T15:00:07.873258Z",
"landing_url": "https://freesound.org/people/benpm/sounds/186942",
"license": "by",
"license_name": "CC BY 4.0",
"license_url": "https://creativecommons.org/licenses/by/4.0/",
"license_version": "4.0",
"mature": false,
"openverse_url": "https://openverse.org/audio/2c51e4eb-dbe7-468c-ba6c-d1c85a1b71ae",
"provider": "freesound",
"sample_rate": null,
"source": "freesound",
"tags": [
"Melody",
"Piano",
"chord",
"music",
"piano"
],
"thumbnail_url": null,
"title": "Piano Melody",
"url": "https://cdn.freesound.org/previews/186/186942_2594536-hq.mp3",
"waveform_url": "https://api.openverse.org/v1/audio/2c51e4eb-dbe7-468c-ba6c-d1c85a1b71ae/waveform/"
}
],
"count": 1
}List related images
Find up to 10 openly licensed images similar to one image, matched on its title and tags.
Inputs
- Image
image_idtextRequired - The image's Openverse id (image_id from 'Search images'), or its openverse.org link.
Outputs
countnumber- How many related images were found (up to 10).
imageslist- Images with similar titles and tags.
Example output
{
"count": 1,
"images": [
{
"attribution": "\"Mountains\" by Kamil Porembi\u0144ski is licensed under CC BY-SA 2.0. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/2.0/.",
"category": null,
"creator": "Kamil Porembi\u0144ski",
"creator_url": "https://www.flickr.com/photos/22178197@N00",
"filesize": null,
"filetype": null,
"height": 680,
"image_id": "f561777d-24ea-483f-9cf8-f17aa1fd6aa3",
"indexed_on": "2020-03-27T18:10:35.161824Z",
"landing_url": "https://www.flickr.com/photos/22178197@N00/16129656628",
"license": "by-sa",
"license_name": "CC BY-SA 2.0",
"license_url": "https://creativecommons.org/licenses/by-sa/2.0/",
"license_version": "2.0",
"mature": false,
"openverse_url": "https://openverse.org/image/f561777d-24ea-483f-9cf8-f17aa1fd6aa3",
"provider": "flickr",
"source": "flickr",
"tags": [
"iceland",
"landscape",
"mountain",
"mountains"
],
"thumbnail_url": "https://api.openverse.org/v1/images/f561777d-24ea-483f-9cf8-f17aa1fd6aa3/thumb/",
"title": "Mountains",
"url": "https://live.staticflickr.com/7539/16129656628_ddd1db38c2_b.jpg",
"width": 1024
}
]
}Search audio
Search millions of openly licensed songs, sound effects, podcasts and recordings from Freesound, Jamendo and Wikimedia Commons. Narrow by license or allowed use, category, length, file type and source. Each track comes with its link, duration, creator, license and ready-made credit text.
Inputs
- Search text
qtext - Words to look for in titles, descriptions and tags, up to 200 characters. Leave empty to search by creator, tags or title instead, or to browse with the filters alone.
- Use
license_typelist - Only works whose license allows these uses, such as commercial use or modifying the work. Leave empty for all.One or more of:
commercial(Use commercially),modification(Modify or adapt),all-cc(Any Creative Commons license),all(Any license). - Licenses
licenselist - Only works under any of these licenses. Leave empty for all.One or more of:
cc0(CC0 (public domain dedication)),pdm(Public Domain Mark),by(CC BY),by-sa(CC BY-SA),by-nd(CC BY-ND),by-nc(CC BY-NC),by-nc-sa(CC BY-NC-SA),by-nc-nd(CC BY-NC-ND),sampling+(Sampling+ (retired)),nc-sampling+(NC Sampling+ (retired)). - Category
categorylist - Only music, sound effects, podcasts and the other kinds chosen.One or more of:
music,sound_effect(Sound effects),podcast(Podcasts),audiobook(Audiobooks),news,pronunciation(Pronunciations). - Length
lengthlist - Only tracks of these lengths.One or more of:
shortest(Under 30 seconds),short(30 seconds to 2 minutes),medium(2 to 10 minutes),long(Over 10 minutes). - File type
extensionlist - Only tracks in these formats.One or more of:
mp3,ogg,oga,opus,flac,wav,mid,webm. - Sources
sourcelist - Only tracks from these collections, such as Freesound or Jamendo. Leave empty for all.
- Leave out sources
excluded_sourcelist - Leave out tracks from these collections. Use this or Sources, not both.
- Creator
creatortext - Only works by a creator whose name matches these words. Leave the search text empty to use it.
- Tags
tagstext - Only works tagged with these words; separate several with commas. Leave the search text empty to use it.
- Title
titletext - Only works whose title contains these words. Leave the search text empty to use it.
- Include sensitive results
maturetrue/false - Also return works marked as sensitive. Off by default.
- Page
pagenumber - Which page of results, starting at 1. Openverse shows the first 240 results of a search, so at 20 a page the last page is 12.From 1 to 240.
- Results per page
page_sizenumber - How many results a page holds, 1 to 20. Openverse's default is 20.From 1 to 20.
Outputs
audiolist- The audio tracks.
countnumber- How many audio tracks are on this page.
pagenumber- The page number these are.
page_countnumber- How many pages those fill.
result_countnumber- How many audio tracks Openverse shows for this search (at most 240 without an account).
summarytext- One line about the page of audio tracks found.
Example output
{
"audio": [
{
"album": null,
"alt_files": [
{
"bit_rate": 0,
"filesize": 1798222,
"filetype": "wav",
"sample_rate": 44100,
"url": "https://freesound.org/apiv2/sounds/186942/download/"
}
],
"attribution": "\"Piano Melody\" by benpm is licensed under CC BY 4.0. To view a copy of this license, visit https://creativecommons.org/licenses/by/4.0/.",
"audio_id": "2c51e4eb-dbe7-468c-ba6c-d1c85a1b71ae",
"bit_rate": 128000,
"category": null,
"creator": "benpm",
"creator_url": "https://freesound.org/people/benpm",
"duration_ms": 10193,
"duration_seconds": 10.2,
"filesize": 227209,
"filetype": "mp3",
"genres": [],
"indexed_on": "2024-05-21T15:00:07.873258Z",
"landing_url": "https://freesound.org/people/benpm/sounds/186942",
"license": "by",
"license_name": "CC BY 4.0",
"license_url": "https://creativecommons.org/licenses/by/4.0/",
"license_version": "4.0",
"mature": false,
"openverse_url": "https://openverse.org/audio/2c51e4eb-dbe7-468c-ba6c-d1c85a1b71ae",
"provider": "freesound",
"sample_rate": null,
"source": "freesound",
"tags": [
"Melody",
"Piano",
"chord",
"music",
"piano"
],
"thumbnail_url": null,
"title": "Piano Melody",
"url": "https://cdn.freesound.org/previews/186/186942_2594536-hq.mp3",
"waveform_url": "https://api.openverse.org/v1/audio/2c51e4eb-dbe7-468c-ba6c-d1c85a1b71ae/waveform/"
}
],
"count": 1,
"page": 1,
"page_count": 80,
"result_count": 240,
"summary": "1 audio track on page 1 of 80, from 240 matches Openverse shows"
}Search images
Search hundreds of millions of openly licensed images from Flickr, Wikimedia Commons, museums and more. Narrow by license or allowed use, image type, aspect ratio, size, file type and source. Each image comes with its link, creator, license and ready-made credit text. No API key required.
Inputs
- Search text
qtext - Words to look for in titles, descriptions and tags, up to 200 characters. Leave empty to search by creator, tags or title instead, or to browse with the filters alone.
- Use
license_typelist - Only works whose license allows these uses, such as commercial use or modifying the work. Leave empty for all.One or more of:
commercial(Use commercially),modification(Modify or adapt),all-cc(Any Creative Commons license),all(Any license). - Licenses
licenselist - Only works under any of these licenses. Leave empty for all.One or more of:
cc0(CC0 (public domain dedication)),pdm(Public Domain Mark),by(CC BY),by-sa(CC BY-SA),by-nd(CC BY-ND),by-nc(CC BY-NC),by-nc-sa(CC BY-NC-SA),by-nc-nd(CC BY-NC-ND),sampling+(Sampling+ (retired)),nc-sampling+(NC Sampling+ (retired)). - Image type
categorylist - Only photographs, illustrations or digitized artworks.One or more of:
photograph(Photographs),illustration(Illustrations),digitized_artwork(Digitized artworks). - Aspect ratio
aspect_ratiolist - Only tall, wide or square images.One or more of:
tall,wide,square. - Size
sizelist - Only small, medium or large images.One or more of:
small,medium,large. - File type
extensionlist - Only images in these formats.One or more of:
jpg,png,gif,svg. - Sources
sourcelist - Only images from these collections, such as Flickr or Wikimedia Commons. Leave empty for all.
- Leave out sources
excluded_sourcelist - Leave out images from these collections. Use this or Sources, not both.
- Creator
creatortext - Only works by a creator whose name matches these words. Leave the search text empty to use it.
- Tags
tagstext - Only works tagged with these words; separate several with commas. Leave the search text empty to use it.
- Title
titletext - Only works whose title contains these words. Leave the search text empty to use it.
- Include sensitive results
maturetrue/false - Also return works marked as sensitive. Off by default.
- Page
pagenumber - Which page of results, starting at 1. Openverse shows the first 240 results of a search, so at 20 a page the last page is 12.From 1 to 240.
- Results per page
page_sizenumber - How many results a page holds, 1 to 20. Openverse's default is 20.From 1 to 20.
Outputs
countnumber- How many images are on this page.
imageslist- The images.
pagenumber- The page number these are.
page_countnumber- How many pages those fill.
result_countnumber- How many images Openverse shows for this search (at most 240 without an account).
summarytext- One line about the page of images found.
Example output
{
"count": 1,
"images": [
{
"attribution": "\"Mountains\" by Kamil Porembi\u0144ski is licensed under CC BY-SA 2.0. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/2.0/.",
"category": null,
"creator": "Kamil Porembi\u0144ski",
"creator_url": "https://www.flickr.com/photos/22178197@N00",
"filesize": null,
"filetype": null,
"height": 680,
"image_id": "f561777d-24ea-483f-9cf8-f17aa1fd6aa3",
"indexed_on": "2020-03-27T18:10:35.161824Z",
"landing_url": "https://www.flickr.com/photos/22178197@N00/16129656628",
"license": "by-sa",
"license_name": "CC BY-SA 2.0",
"license_url": "https://creativecommons.org/licenses/by-sa/2.0/",
"license_version": "2.0",
"mature": false,
"openverse_url": "https://openverse.org/image/f561777d-24ea-483f-9cf8-f17aa1fd6aa3",
"provider": "flickr",
"source": "flickr",
"tags": [
"iceland",
"landscape",
"mountain",
"mountains"
],
"thumbnail_url": "https://api.openverse.org/v1/images/f561777d-24ea-483f-9cf8-f17aa1fd6aa3/thumb/",
"title": "Mountains",
"url": "https://live.staticflickr.com/7539/16129656628_ddd1db38c2_b.jpg",
"width": 1024
}
],
"page": 1,
"page_count": 120,
"result_count": 240,
"summary": "1 image on page 1 of 120, from 240 matches Openverse shows"
}