From 9f6e721b7201cf345540ad00217f9524515f112f Mon Sep 17 00:00:00 2001 From: Goziee-git Date: Mon, 3 Nov 2025 10:33:05 +0100 Subject: [PATCH 1/2] docs: add Openverse API source with limitation notes --- sources.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/sources.md b/sources.md index 3d396294..20b84169 100644 --- a/sources.md +++ b/sources.md @@ -121,6 +121,25 @@ and access towards related query data using a programmable search engine. - Data available through JSON format +## Openverse + +**Description:** Openverse is a search engine for openly licensed media, including images and audio. It provides access to over 700 million works from more than 20 sources, all of which are under Creative Commons licenses or in the public domain. The API allows querying for media by source, license type, and other parameters. Because anonymous Openverse API access returns a maximum of ~240 result count per source-license combination, the `openverse_fetch.py` script currently provides approximate counts. It does not include pagination or license_version breakdown. + +**API documentation link:** +- [Openverse API Documentation](https://api.openverse.org/v1/) +- [Openverse API Reference](https://wordpress.org/openverse/api/) +- [Base URL](https://api.openverse.org/v1) +- [Openverse Frontend](https://openverse.org/) + +**API information:** +- No API key required for basic access +- Query limit: Rate-limited to prevent abuse (anonymous access provides ~240 results per source-license combination) +- Data available through JSON format +- Supports filtering by source, license, media type (images, audio) +- Media types: `images`, `audio` +- Supported licenses: `by`, `by-nc`, `by-nc-nd`, `by-nc-sa`, `by-nd`, `by-sa`, `cc0`, `nc-sampling+`, `pdm`, `sampling+` + + ## Wikipedia **Description:** The Wikipedia API allows users to query statistics of pages, From 4d224a32b413e4c8909229bc7ed930dd87842001 Mon Sep 17 00:00:00 2001 From: Goziee-git Date: Mon, 3 Nov 2025 12:03:38 +0100 Subject: [PATCH 2/2] chore: hardwrap Openverse description for better readability --- sources.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/sources.md b/sources.md index 20b84169..2f559bef 100644 --- a/sources.md +++ b/sources.md @@ -123,7 +123,14 @@ and access towards related query data using a programmable search engine. ## Openverse -**Description:** Openverse is a search engine for openly licensed media, including images and audio. It provides access to over 700 million works from more than 20 sources, all of which are under Creative Commons licenses or in the public domain. The API allows querying for media by source, license type, and other parameters. Because anonymous Openverse API access returns a maximum of ~240 result count per source-license combination, the `openverse_fetch.py` script currently provides approximate counts. It does not include pagination or license_version breakdown. +**Description:** Openverse is a search engine for openly licensed media, +including images and audio. It provides access to over 700 million works from +more than 20 sources, all of which are under Creative Commons licenses or in the +public domain. The API allows querying for media by source, license type, and +other parameters. Because anonymous Openverse API access returns a maximum of +~240 result count per source-license combination, the `openverse_fetch.py` +script currently provides approximate counts. It does not include pagination or +license_version breakdown. **API documentation link:** - [Openverse API Documentation](https://api.openverse.org/v1/)