Amazon Music Device API
Suggest
The Suggest endpoint is used to give auto-completed search suggestions to the user based on what they are typing.
URL : suggestions/
Method : GET
Auth required : YES
Query Parameters
Name | Data Type | Required | Description |
---|---|---|---|
keywords | string | Yes | The keyword string to search for |
size | integer | No | The maximum number of suggestions to return |
Overview
The keywords
parameter is used to pass what the user is typing to the API. The parameter size
can also be passed to indicate the max number of suggestions returned. The API returns a maximum number of 10. If a larger size is specified, it will return only 10.
A sample request and its response:
https://music-api.amazon.com/suggestions/?keywords=hello&size=10
{
"suggestions": [
{ "term": "hello" },
{ "term": "hello adele" },
{ "term": "helloween" },
{ "term": "hello in there john prine" },
{ "term": "hello lionel richie" },
{ "term": "hello its me todd rundgren" },
{ "term": "hello in there" },
{ "term": "hello goodbye beatles" },
{ "term": "hello darlin conway twitty" },
{ "term": "hello stranger barbara lewis" }
],
"version": "1.1"
}