Shazam API
9.6 / 10
3,222ms
95%
93%
README
Shazam API Documentation
Overview
The Shazam API provides various endpoints to perform actions related to song recognition, artist and track information, and other related features.
The Shazam API currently does not require authentication for accessing public endpoints.
Paths
1. Recognize Song from Audio URL
GET /shazam/recognize/
Recognize a song from an audio URL.
Parameters
url(query parameter, required): The URL of the audio file.
Responses
200 OK: Successful response.422 Validation Error: If there is a validation error.
2. Recognize Song from Audio File
POST /shazam/recognize/
Recognize a song from an audio file.
Request Body
multipart/form-data: Form data containing the audio file.
Responses
200 OK: Successful response.422 Validation Error: If there is a validation error.
3. Search Artist
GET /shazam/search_artist/
Search for an artist.
Parameters
query(query parameter, required): The artist’s name or query string.limit(query parameter, optional): Limit the number of results (default: 10).
Responses
200 OK: Successful response.422 Validation Error: If there is a validation error.
4. Search Track
GET /shazam/search_track/
Search for a track.
Parameters
query(query parameter, required): The track’s name or query string.limit(query parameter, optional): Limit the number of results (default: 10).
Responses
200 OK: Successful response.422 Validation Error: If there is a validation error.
5. About Artist
GET /shazam/about_artist
Get information about an artist.
Parameters
artist_id(query parameter, required): The unique identifier of the artist.
Responses
200 OK: Successful response.422 Validation Error: If there is a validation error.
6. About Track
GET /shazam/about_track
Get information about a track.
Parameters
track_id(query parameter, required): The unique identifier of the track.
Responses
200 OK: Successful response.422 Validation Error: If there is a validation error.
7. Track Listenings Count
GET /shazam/track_listenings_count
Get the number of listenings for a track.
Parameters
track_id(query parameter, required): The unique identifier of the track.
Responses
200 OK: Successful response.422 Validation Error: If there is a validation error.
8. Similar Tracks
GET /shazam/similar_tracks
Get similar tracks for a given track.
Parameters
track_id(query parameter, required): The unique identifier of the track.limit(query parameter, optional): Limit the number of results (default: 10).offset(query parameter, optional): Offset for pagination (default: 0).
Responses
200 OK: Successful response.422 Validation Error: If there is a validation error.
9. Top Artist Tracks
GET /shazam/top_artist_tracks
Get top tracks for a given artist.
Parameters
artist_id(query parameter, required): The unique identifier of the artist.
Responses
200 OK: Successful response.422 Validation Error: If there is a validation error.
10. Top Tracks in City
GET /shazam/top_tracks_city
Get top tracks in a specific city.
Parameters
country_code(query parameter, optional, default: “RU”): The country code of the city.city_name(query parameter, optional, default: “Moscow”): The name of the city.limit(query parameter, optional): Limit the number of results (default: 10).
Responses
200 OK: Successful response.422 Validation Error: If there is a validation error.
11. Top Tracks in Country
GET /shazam/top_tracks_country
Get top tracks in a specific country.
Parameters
country_code(query parameter, optional, default: “UZ”): The country code.limit(query parameter, optional): Limit the number of results (default: 10).
Responses
200 OK: Successful response.422 Validation Error: If there is a validation error.
Error Handling
In case of errors, the API will respond with appropriate HTTP status codes and error messages in the response body. Please refer to the specific endpoint documentation for details on possible errors.
Rate Limiting
The Shazam API has rate limiting in place to ensure fair usage. Exceeding the rate limits may result in temporary or permanent suspension of access. Please refer to the specific endpoint documentation for rate limit details.
Contact
For any inquiries or support, please contact support@your-api.com.
