Skip to main content

​
Accessing the API

To use the WavMaker API, you’ll need to generate an API key in the account dashboard.
Screenshot showing how to generate an API key in the WavMaker dashboard
If you don’t see the API Keys tab on your account dashboard, it may be because you’re account has not yet been approved for API access. Please contact [email protected] to get your account approved.

​
Authentication

All API requests must be authenticated using a Bearer token. Include your API token in the Authorization header of every request: 
curl -H "Authorization: Bearer YOUR_API_TOKEN" https://api.wavmaker.com/songs
If your token is missing or invalid, you’ll receive a 401 Unauthorized error.

​
Rate Limit

The WavMaker API has a rate limit of 25 requests per second. If you exceed the rate limit, you will receive a 429 error.

​
Pagination

For all endpoints that return a list of results, pagination is supported. Query Parameters:
  • page (integer): Which page of results to return (default: 1)
  • limit (integer): Number of results per page (default: 20, max: 100)
Response Fields: 
{
  "page": 1,
  "pages": 5,
  "page_size": 20,
  "total": 100,
  "hits": [ ... ]
}

​
Making Your First API Request

  1. Choose the API endpoint you want to use
  2. Generate your API Key in the dashboard
  3. Use your favorite HTTP client to make a request. Example:
curl -X GET "https://wavmaker.com/api/v1/songs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"