Media assets WordPress / Openverse
Openverse API
Find reusable images and sound through a single search API, then inspect the licence attached to each result.
Source review: 2026-10-31 · Imported: 1 November 2026
A practical starting point
What could you build?
A writing assistant can suggest illustrations and audio for a draft while keeping creator credits alongside the assets.
Before you connect
Keep each asset’s licence and attribution with the download. Anonymous access has a small daily allowance, so cache searches.
Capabilities & requirements
Dated specifications from the licensed source dataset. “Not published” indicates missing information, rather than confirmed absence.
| Capability | Details and source |
|---|---|
| Status | Not published No GA/beta label in the Openverse docs; the API is served as /v1/ and the latest API changelog entry is release 2026.10.13. Source (external) · Not published by vendor: checked 2026-10-17 on https://docs.openverse.org/ |
| API key required | No key Anonymous request returned HTTP 200; registering gives higher limits. Source (external) · Verified 2026-10-17 by test request to https://api.openverse.org/v1/audio/?q=whoosh&page_size=1 |
| Free tier | Free (anonymous tier) The API terms reserve the right to charge fees for commercial or heavy use in future. Source (external) · Verified 2026-10-17 on https://docs.openverse.org/terms_of_service.html |
| Rate limit | 20/min, 200/day (anonymous) x-ratelimit-limit-anon_burst and anon_sustained headers on the source publisher’s test request. Source (external) · Verified 2026-10-17 by test request to https://api.openverse.org/v1/audio/?q=whoosh&page_size=1 |
| Official MCP server | Not published No official MCP server is listed in the Openverse docs. Source (external) · Not published by vendor: checked 2026-10-17 on https://docs.openverse.org/ |
| Official SDK | JS client (pre-release) @openverse/api-client, in the WordPress/openverse repo; npm version 0.0.1-a1. Source (external) · Verified 2026-10-17 on https://github.com/WordPress/openverse/tree/main/packages/js/api-client |
| Data license / terms | Per-item CC licenses Every result carries license and license_url; Openverse does not verify licensing status (terms section 3). Source (external) · Verified 2026-10-17 on https://docs.openverse.org/terms_of_service.html |
| Commercial use allowed | Per item license Filter with license_type=commercial; apps must say they are made with Openverse. Source (external) · Verified 2026-10-17 on https://docs.openverse.org/terms_of_service.html |
| CORS / browser use | Access-Control-Allow-Origin: * Returned on a GET with a third-party Origin header. Source (external) · Verified 2026-10-17 by test request to https://api.openverse.org/v1/audio/?q=whoosh&page_size=1 |
| Freshness / coverage | 915M images, 5.2M audio Sum of media_count: 915,519,784 images across 52 sources and 5,218,767 audio files across 3 sources. Source (external) · Verified 2026-10-17 by test request to https://api.openverse.org/v1/images/stats/ |
Operational reference
Additional facts and qualifications retained from AgentAPIList’s CC BY 4.0 dataset, with provider references.
API key / auth
Not required. Optional OAuth2: POST /v1/auth_tokens/register/ (name, description, email) returns a client_id and client_secret; POST /v1/auth_tokens/token/ with grant_type=client_credentials returns a Bearer token (expires_in 36000 s). Verify your email first, or the app keeps anonymous limits.
Provider reference (external)Rate limit (anonymous)
20 requests/min burst and 200 requests/day sustained, per the x-ratelimit headers on the source publisher’s test request (re-checked 2026-10-31). Over the limit returns 429.
Provider reference (external)Rate limit (registered)
Openverse says registered apps get “slightly higher limits” and does not publish the numbers; GET /v1/rate_limit/ reports your own usage and rate_limit_model. Larger increases are by request.
Provider reference (external)Page size
Anonymous requests: page_size max 20 (the API returns “page_size may not exceed 20 for anonymous requests”). Registered users may request larger pages. Scraping is disallowed by the terms.
Provider reference (external)Terms
Use of the API is subject to the Openverse Terms of Service (docs.openverse.org/terms_of_service.html); respect each result’s Creative Commons (or similar) license and credit creators when required.
Provider reference (external)Audio catalog
5,218,767 audio files across Jamendo, Wikimedia Commons and Freesound (sum of media_count from /v1/audio/stats/ on the check date).
Provider reference (external)Licensing
Each result carries its own license and license_url (e.g. CC0, CC BY). Filter with license=cc0 or license_type=commercial; each result also has a ready-made attribution string to paste where the license requires credit.
Provider reference (external)Endpoint
GET https://api.openverse.org/v1/audio/?q=… (images: /v1/images/)
Provider reference (external)Setup references
HTTP request example
Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.
curl -sS "https://api.openverse.org/v1/audio/?q=rain&license=cc0&page_size=1"Agent connection example
Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.
// Agent tool definition (JSON Schema) — implement with HTTP GET
{
"name": "openverse_audio_search",
"description": "Search openly licensed audio on Openverse. No API key. Stay under 20 req/min.",
"input_schema": {
"type": "object",
"properties": {
"q": { "type": "string", "description": "Search keywords" },
"license": { "type": "string", "description": "e.g. cc0" },
"page_size": { "type": "integer", "minimum": 1, "maximum": 20 }
},
"required": ["q"]
}
}
// GET https://api.openverse.org/v1/audio/?q={q}&license={license}&page_size={page_size}A tool schema needs an HTTP implementation; it does not by itself install an MCP server. Keep credentials out of browser code.
Other connections to explore
- Wikipedia REST API (external)
- Open-Meteo API (external)
- Freesound API (external)
- Poly Haven API (external)
- ambientCG API (external)
Source & reuse
Download the complete licensed source snapshot (JSON), including the original source’s caveats, alternative notes and examples.