The artist.tools API provides access to powerful Spotify insights—ideal for developers building dashboards, automation tools, and analytics platforms for the music industry.

This guide outlines the steps required to get started and important usage guidelines to ensure a smooth experience.

Prerequisites

Before you can use the API, make sure you've completed the following:

Join the Developer Access Plan
Go to your Developer Settings to confirm your subscription or upgrade.
Create an API Key
From the Developer Settings page, generate your API key. This key must be included in every request to authenticate your access.

Rate Limits and Fair Use

To ensure the API remains fast and reliable for all users, the following policies apply:

Rate Limit

You are allowed 1 request per second and 10,000 requests per day.
If this limit is exceeded, you'll receive a 429 Too Many Requests error.
Make sure your application includes rate limiting or backoff logic to handle retries.

For high-volume or enterprise use cases, contact us to discuss custom access levels.

Fair Use Policy

We actively monitor usage patterns. If we detect activity that negatively impacts other users, we may:

Reach out to clarify your use case / optimize your implementation
Throttle or temporarily restrict your access if necessary

Authentication

Include your API key in the x-api-key header of every request. For example:

GET /v2/playlists/:playlist_id
Host: api.artist.tools
x-api-key: your-api-key-here

Next Steps

API documentation will outline available endpoints, response formats, and error handling.
If you have technical questions or need access to early documentation, email aaron@artist.tools.
If there's an endpoint missing, let us know and we'll consider adding it.

We're excited to see what you build!