API documentation

Quick start

Public endpoints are free and require no authentication. Use /api/feed for recent plays across all channels, cached for two minutes.

curl "https://xmplaylist.com/api/feed" \
  -H "User-Agent: xmplaylist-integration/1.0"

Request guidelines

• Include a User-Agent header.
• Use /api/feed instead of polling each channel.
• Respect rate limits and caching headers in responses.
• Endpoints and response formats may change.

Authentication

Use an API key to access authenticated endpoints, including search and reports. Create one in your profile and send it as a bearer token in the Authorization header.

Your account’s plan determines access to paid features and daily request limits.

curl --get "https://xmplaylist.com/api/reports/track-lookup" \
  --data-urlencode "trackName=hello" \
  -H "Authorization: Bearer ${apiKey}" \
  -H "User-Agent: xmplaylist-integration/1.0"

AI assistants

xmplaylist is available in ChatGPT and Claude, and as a custom connector in Grok. Your assistant signs in with your xmplaylist account, so no API key is needed. Connect your assistant.

Assistant requests count toward the same daily limit as your API key.

Documentation, admin, profile usage, and search-alert management requests are not metered.