List of Hits

GET /v1/entities/hit

Retrieves a list of hits.

Request Parameters

Location Parameter Type Required/ Optional Description
query offset number optional The numeric offset of the first record to return. May be a value between 1 and 1000 inclusive
query cursor string optional The cursor ID of the first record to return. Example: cymbal_crash
query limit number optional The number of records to return. May be a value between 1 and 100 inclusive. If a value is not specified, the default is 10.
query id string optional Filter. Will match to records whose id contains the given string
query name string optional Filter. Will match to records whose name contains the given string

For a description of how to use these query parameters, see Pagination.

Example Request

GET /v1/entities/hit?offset=0&limit=2 HTTP/1.1
Host: api.ampermusic.com
Content-Type: application/vnd.api+json
Authorization: Basic abcxyz

Response Data

Data Item Type Description
data array
data[].type string The type of data (entity_hit in this case).
data[].id string The string ID of the hit.
data[].attributes object
data[].attributes.name string The string name of the hit.
data[].attributes.preview array
data[].attributes.preview[].url string The string url of the hit’s preview file
data[].attributes.preview[].content_type string enum The content type of the preview. Of the following values:
audio/mp3
audio/ogg
data[].links object
data[].links.self string The URL of the hit
links object
links.self string The URL of this list of hits
links.first string The URL of the first (or possibly only) page of results. It is always available
links.prev string The URL of the previous page of results when using offset/limit mode. It is omitted if there is no previous page and is not available in cursor/limit mode
links.next string The URL of the next page of results when using offset/limit mode. It is omitted if there are no additional pages and is available on the first page, and on any subsequent page, accessed with offset/limit mode
links.next_cursor string The URL of the next page of results when using cursor/limit mode. It is omitted if there are no additional pages and is available on the first page, and on any subsequent page, accessed with cursor/limit mode

Example Response

Header

HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

Body

{
	"data": [
		{
			"attributes": {
				"name": "Cymbal Crash",
				"preview": [
					{
						"content_type": "audio/mp3",
						"url": "<some_url>"
					},
					{
						"content_type": "audio/ogg",
						"url": "<some_url>"
					}
				]
			},
			"id": "cymbal_crash",
			"links": {
				"self": "https://api.ampermusic.com/v1/entities/hit/cymbal_crash"
			},
			"type": "entity_hit"
		},
		{
			"attributes": {
				"name": "Cymbal Swell 1s",
				"preview": [
					{
						"content_type": "audio/mp3",
						"url": "<some_url>"
					},
					{
						"content_type": "audio/ogg",
						"url": "<some_url>"
					}
				]
			},
			"id": "cymbal_swell_1s",
			"links": {
				"self": "https://api.ampermusic.com/v1/entities/hit/cymbal_swell_1s"
			},
			"type": "entity_hit"
		}
	],
	"links": {
		"first": "https://api.ampermusic.com/v1/entities/hit?limit=2",
		"next": "https://api.ampermusic.com/v1/entities/hit?limit=2&offset=2",
		"next_cursor": "https://api.ampermusic.com/v1/entities/hit?limit=2&cursor=cymbal_swell_2s",
		"self": "https://api.ampermusic.com/v1/entities/hit?limit=2"
	}
}