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"

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