How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Openverse auth API

Openverse provides free and open access to the Openverse API toanonymous and registered users. [Refer to the API documentationsite for information on how to register](https://api.openverse.org/v1/#tag/auth).All Openverse API users are subject to rate limits and restrictionson how much of Openverse's dataset can be accessed through the API.[Individuals should contact Openverse to request expanded access tothe API](https://github.com/WordPress/openverse#keep-in-touch).Requests are considered on a case-by-case basis and are subject toevaluation in light of [Openverse's Terms of Service](https://docs.openverse.org/terms_of_service.html).Escalated access may be revoked at any time.To authenticate yourself, you must sign up for an API key usingthe `register` endpoint and then get an access token using the`token` endpoint. Read on to know about these endpoints.In subsequent requests, include your access token as a bearertoken in the `Authorization` header.```Authorization: Bearer ```### Rate limitsOpenverse endpoints are rate limited. Anonymous requests should besufficient for most users. Indeed, https://openverse.org itselfoperates using anonymous requests from the browser.Registered users are automatically granted slightly higher limits.Further increases to rate limits are available upon request (see above).Every Openverse API response that was subject to rate-limits includesheaders outlining the permitted and available usage. Exceeding the limitwill result in '429: Too Many Requests' responses.### PaginationOpenverse's dataset is valuable, and the[Terms of Service](https://docs.openverse.org/terms_of_service.html)disallow scraping under all circumstances. As such, paginationfor anonymous users is limited, accommodating only the typicalusage on https://openverse.org. Pagination is limited in termsof the size of individual pages and the total number of worksvisible for a query (pagination depth).Authenticated users are subject to the same limit of total worksavailable for a query, but may request larger individual pages.Increases to pagination limits on page size and total depth areavailable upon request (see above).

Openverse auth API is one of 3 APIs that Openverse publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Authentication. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, a GitHub repository, and rate-limit docs.

This API exposes 3 operations across 3 paths, and defines 9 schemas. It is described by OpenAPI 3.0.3, at version 909aa41ddf2115a69a447198b3f49121481e0c6b (v1).

Requests are made against the base URL https://api.openverse.org/v1.

3 operations 3 paths 9 schemas 1 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
909aa41ddf2115a69a447198b3f49121481e0c6b (v1)
Base URL
https://api.openverse.org/v1
Authentication
HTTP Bearer
Contact
Terms of Service
Resource Areas
1

Authentication & Security 1

Openverse auth API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (Openverse API Token).

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 1 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

auth 3

Openverse provides free and open access to the Openverse API to anonymous and registered users. [Refer to the API documentation site for information on how to register](https://ap…

POST
/v1/auth_tokens/register/
Register an application to access to API via OAuth2. Upon registering, you will receive a clientid and clientsecret, which you can then use to authenticate using the standard OAuth2 flow. ⚠️ WARNINGS…
register body → 201400401429
POST
/v1/auth_tokens/token/
Get an access token using client credentials. To authenticate your requests to the Openverse API, you need to provide an access token as a bearer token in the Authorization header of your requests. T…
token body → 200401400
GET
/v1/rate_limit/
Get information about your API key. You can use this endpoint to get information about your API key such as requeststhisminute, requeststoday, and ratelimitmodel. ℹ️ NOTE: If you get a 401 Unauthoriz…
key_info → 200401429500

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are OAuth2Application (4 properties), OAuth2KeyInfo (4 properties), OAuth2Token (4 properties), OAuth2TokenRequest (3 properties). Each schema is shown below with its type and property counts.

OAuth2KeyInfo
object
4 properties 4 required
OAuth2TokenRequest
object
Serializes a request for an access token. This is a dummy serializer for OpenAPI and is not actually used.
3 properties 3 required
GrantTypeEnum
string
clientcredentials - clientcredentials
OAuth2Registration
object
3 properties 3 required
OAuth2Token
object
Serializes the response for an access token. This is a dummy serializer for OpenAPI and is not actually used.
4 properties 4 required
APIException
object
1 property
OAuth2Application
object
4 properties 4 required
ValidationError
object
1 property
NotAuthenticated
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

openverse-auth-api-openapi.yml Raw ↑

Other APIs Openverse publishes across the network.

Openverse audio API
Openverse images API
Where this information came from

This is an independent, third-party profile of Openverse auth API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.