← All agent tools

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.

Openverse API specifications
CapabilityDetails and source
StatusNot 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 requiredNo 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 tierFree (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 limit20/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 serverNot 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 SDKJS 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 / termsPer-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 allowedPer 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 useAccess-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 / coverage915M 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

Back to the full directory →

Source & reuse

Download the complete licensed source snapshot (JSON), including the original source’s caveats, alternative notes and examples.