Search song by name
This search endpoint is intended for internal use only. If you wish to expose it on externally facing websites, it is limited to certain plans. Reach out if you have any questions.
Search for songs with a single query.
We highly suggest you search for a song using the song name and the artist name
The search engine is typo-tolerant, and patterns such as the following will still show “Let’s dance David Bowie” as the top result:
- Let’s dance David
- Let’s bance David Bowie
- let's danse david bowie
Request
GET /api/v2/song/search/{term}
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| term | string | A name or an identifier |
Required |
Query string parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| offset | integer | Get results starting from position |
|
| limit | integer | Number of results (max. 20) |
Response
| Status code | Description | Resource |
|---|---|---|
| 200 | OK
A song collection response with the 20 most pertinent songs |
Song Collection |
| 401 | Unauthorized
You are not logged in |
|
| 403 | Forbidden
This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access. |
|
| 404 | Not Found
No song found for this term |