Song Search

Search for songs across the catalog using keywords that match both song titles and artist names. This flexible search returns relevant results without requiring an exact title match, enabling broad discovery within the music metadata. For precise title-only searches, consider using the AdvancedSongSearch.

Search for songs. The max number of results that can be retrieved using the combination of offset and count is 10,000.

Note: This search API is not STRICT on song title only, it does include an Artists Name as part of the search algorithm. If you are requiring a STRICT search on title, use AdvancedSongSearch, with input only on title.

Security Model

API Key Authentication

Header Parameters

StoreIdstring Required

API key provided by Tuned Global to authenticate and authorize service access

Countrystring

Optional. ISO 3166-1 alpha-2 country code (e.g. AU, TW) used to apply territory rights. Defaults to your store's default country when omitted. Results are only filtered by country when applyCountryFilter=true.

Query Parameters

qstring Required

Text string used as the search query

offsetinteger

Starting record number for pagination, default is 1

countinteger

Maximum number of results to return, default is 10

applyCountryFilterboolean

f true, restricts results to the resolved country's catalogue (from the Country header, or the client's default home country if not supplied).

Response

200

Object

Response Attributes

keystring

Unique identifier for the search result entry

doc_countstring

Number of documents or records matching a specific criteria

resultsobject

The array or list of song entries matching the search query

Show child attributes

Sections

Song Search

Security Model

Header Parameters

Query Parameters

Response

Response Attributes

Language Box

Response

Sections

Song Search

Security Model

Header Parameters

Query Parameters

ResponseExpand all

Response Attributes

Language Box

Response

Response