suno.com APIsuno.com ↗
Access Suno's explore feeds, trending songs, and playlist contents via API. Retrieve song metadata including audio URLs, play counts, tags, and artist info.
curl -X GET 'https://api.parse.bot/scraper/1e1a9405-ba82-4a65-99e1-e5088bf87a04/explore_songs?limit=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Browse songs from Suno's explore page. Returns curated songs from various feeds (Staff Picks, Best Of, etc.) with cursor-based pagination.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of songs to return. |
| cursor | string | Pagination cursor from previous response's next_cursor field. Omit for first page. |
{
"type": "object",
"fields": {
"songs": "array of song objects with id, title, artist, audio_url, play_count, duration, tags, and other metadata",
"next_cursor": "string pagination cursor for next page, or null if no more results",
"total_returned": "integer count of songs returned in this response"
},
"sample": {
"data": {
"songs": [
{
"id": "283a1bc8-0ada-4f07-ab43-87763aef527e",
"url": "https://suno.com/song/283a1bc8-0ada-4f07-ab43-87763aef527e",
"tags": "Uk drill singing",
"title": "Fr u busy ?",
"artist": "Ama",
"duration": 66.4,
"audio_url": "https://cdn1.suno.ai/283a1bc8-0ada-4f07-ab43-87763aef527e.mp3",
"image_url": "https://cdn2.suno.ai/image_283a1bc8-0ada-4f07-ab43-87763aef527e.jpeg",
"created_at": "2026-05-04T23:46:03.867Z",
"play_count": 30412,
"upvote_count": 539,
"artist_handle": "missyuhbibi",
"comment_count": 94,
"model_version": "v5.5"
}
],
"next_cursor": "3",
"total_returned": 3
},
"status": "success"
}
}About the suno.com API
The Suno API provides 3 endpoints for browsing AI-generated music on Suno, returning song metadata across curated explore feeds, trending charts, and named playlists. The get_trending_songs endpoint returns songs ranked by trending score, while explore_songs supports cursor-based pagination through staff-picked and curated feeds. Each song object includes fields like audio_url, play_count, duration, tags, artist, and title.
What the API Returns
All three endpoints return arrays of song objects sharing a consistent shape: id, title, artist, audio_url, play_count, duration, and tags. The audio_url field gives a direct link to the generated audio track, and play_count reflects how many times a song has been played on the platform. Tags describe the style, genre, or mood applied during generation.
Endpoints in Detail
explore_songs pulls from Suno's curated feeds — including Staff Picks and Best Of collections — and uses cursor-based pagination via the next_cursor response field. Pass the cursor value back as the cursor input param to advance through pages; omit it to start from the beginning. get_trending_songs takes an optional limit param and returns songs sorted by trending score, along with a total_available count. get_playlist_songs requires a playlist_id UUID and uses 1-indexed page-based pagination. Playlist IDs appear in explore_songs responses or can be read from Suno playlist URLs.
Pagination Patterns
explore_songs uses cursor-based pagination — store the next_cursor from each response and pass it to the next call. get_playlist_songs uses integer page numbers (page=1, page=2, etc.) alongside limit, and returns current_page, total_returned, and total_available so you can calculate how many pages remain. get_trending_songs does not paginate; it returns up to the requested limit from the available trending set.
- Build a trending AI music dashboard using
play_countand trending score data fromget_trending_songs - Aggregate tagged songs by genre or mood using the
tagsfield across explore feed pages - Embed audio players in an app by retrieving
audio_urlvalues from playlist or explore results - Track how
play_countchanges over time for specific song IDs to monitor engagement trends - Mirror a curated Suno playlist into an external music library using
get_playlist_songswith pagination - Discover new AI-generated artists by collecting unique
artistvalues from explore feeds - Populate a music recommendation engine using metadata like
duration,tags, andplay_count
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Suno have an official developer API?+
What does the `explore_songs` endpoint return, and how does pagination work?+
explore_songs returns an array of song objects from Suno's curated feeds (such as Staff Picks and Best Of), along with a next_cursor string. Pass that cursor value as the cursor input parameter on the next call to retrieve the following page. When next_cursor is null, there are no more results.Can I retrieve a specific song's full detail page, lyrics, or generation prompts?+
id, title, artist, audio_url, play_count, duration, and tags — but does not expose lyrics, generation prompts, or individual song detail pages as a dedicated endpoint. You can fork this API on Parse and revise it to add a song-detail endpoint covering those fields.How do I find a playlist ID to use with `get_playlist_songs`?+
explore_songs, or you can read them directly from Suno playlist URLs in your browser (e.g., suno.com/playlist/<uuid>). Pass that UUID as the required playlist_id parameter.