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

ActionWhat it does
Get audioGet one openly licensed audio track's details: its file link, duration, other formats, album, creator, license, credit text, source and tags.
Get audio waveformGet 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 imageGet one openly licensed image's details: its file link and size, creator, license, credit text, source and tags.
Get image embed detailsGet 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 sourcesList the collections Openverse's audio comes from, such as Freesound and Jamendo, with how many tracks each holds, largest first.
List image sourcesList the collections Openverse's images come from, such as Flickr and Wikimedia Commons, with how many images each holds, largest first.
List related audioFind up to 10 openly licensed audio tracks similar to one track, matched on its title and tags.
List related imagesFind up to 10 openly licensed images similar to one image, matched on its title and tags.
Search audioSearch millions of openly licensed songs, sound effects, podcasts and recordings from Freesound, Jamendo and Wikimedia Commons.
Search imagesSearch 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 trackaudio_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 trackaudio_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

Imageimage_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

ImageimagetextRequired
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
}

Find up to 10 openly licensed audio tracks similar to one track, matched on its title and tags.

Inputs

Audio trackaudio_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
}

Find up to 10 openly licensed images similar to one image, matched on its title and tags.

Inputs

Imageimage_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 textqtext
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.
Uselicense_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).
Licenseslicenselist
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)).
Categorycategorylist
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).
Lengthlengthlist
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 typeextensionlist
Only tracks in these formats.One or more of: mp3, ogg, oga, opus, flac, wav, mid, webm.
Sourcessourcelist
Only tracks from these collections, such as Freesound or Jamendo. Leave empty for all.
Leave out sourcesexcluded_sourcelist
Leave out tracks from these collections. Use this or Sources, not both.
Creatorcreatortext
Only works by a creator whose name matches these words. Leave the search text empty to use it.
Tagstagstext
Only works tagged with these words; separate several with commas. Leave the search text empty to use it.
Titletitletext
Only works whose title contains these words. Leave the search text empty to use it.
Include sensitive resultsmaturetrue/false
Also return works marked as sensitive. Off by default.
Pagepagenumber
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 pagepage_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 textqtext
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.
Uselicense_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).
Licenseslicenselist
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 typecategorylist
Only photographs, illustrations or digitized artworks.One or more of: photograph (Photographs), illustration (Illustrations), digitized_artwork (Digitized artworks).
Aspect ratioaspect_ratiolist
Only tall, wide or square images.One or more of: tall, wide, square.
Sizesizelist
Only small, medium or large images.One or more of: small, medium, large.
File typeextensionlist
Only images in these formats.One or more of: jpg, png, gif, svg.
Sourcessourcelist
Only images from these collections, such as Flickr or Wikimedia Commons. Leave empty for all.
Leave out sourcesexcluded_sourcelist
Leave out images from these collections. Use this or Sources, not both.
Creatorcreatortext
Only works by a creator whose name matches these words. Leave the search text empty to use it.
Tagstagstext
Only works tagged with these words; separate several with commas. Leave the search text empty to use it.
Titletitletext
Only works whose title contains these words. Leave the search text empty to use it.
Include sensitive resultsmaturetrue/false
Also return works marked as sensitive. Off by default.
Pagepagenumber
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 pagepage_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"
}

On this page