Skip to content

Commit 6482d63

Browse files
authored
Merge pull request #231 from Goziee-git/feature/openverse-docs
Add Openverse API source to documentation in `sources.md`
2 parents cc1ae57 + 4d224a3 commit 6482d63

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

sources.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,6 +121,32 @@ and access towards related query data using a programmable search engine.
121121
- Data available through JSON format
122122

123123

124+
## Openverse
125+
126+
**Description:** Openverse is a search engine for openly licensed media,
127+
including images and audio. It provides access to over 700 million works from
128+
more than 20 sources, all of which are under Creative Commons licenses or in the
129+
public domain. The API allows querying for media by source, license type, and
130+
other parameters. Because anonymous Openverse API access returns a maximum of
131+
~240 result count per source-license combination, the `openverse_fetch.py`
132+
script currently provides approximate counts. It does not include pagination or
133+
license_version breakdown.
134+
135+
**API documentation link:**
136+
- [Openverse API Documentation](https://api.openverse.org/v1/)
137+
- [Openverse API Reference](https://wordpress.org/openverse/api/)
138+
- [Base URL](https://api.openverse.org/v1)
139+
- [Openverse Frontend](https://openverse.org/)
140+
141+
**API information:**
142+
- No API key required for basic access
143+
- Query limit: Rate-limited to prevent abuse (anonymous access provides ~240 results per source-license combination)
144+
- Data available through JSON format
145+
- Supports filtering by source, license, media type (images, audio)
146+
- Media types: `images`, `audio`
147+
- Supported licenses: `by`, `by-nc`, `by-nc-nd`, `by-nc-sa`, `by-nd`, `by-sa`, `cc0`, `nc-sampling+`, `pdm`, `sampling+`
148+
149+
124150
## Wikipedia
125151

126152
**Description:** The Wikipedia API allows users to query statistics of pages,

0 commit comments

Comments
 (0)