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"
}