Artist Search

Search the database for a list of artists that match a specific query string.

Endpoint

https://www.pollstar.com/api/v2/artists/search/{artistName}

Parameters

artistName
The name of the artist to find.
page
[optional] The zero-based index of the page number to select. Selecting a page number that is higher than the number of available pages will succeed with an empty response.
pageSize
[optional] The size of each page. Using a combination of the page and pageSize parameters, you can create a custom paging solution. The default pageSize is 20.

Remarks

This endpoint will return a list of matching artists based on the artistName parameter. It does not guarantee that a unique artist will be returned – it will return all artists that match some part of the search string, ranked by most likely match first. The higher the value of the rank element in the result set, then the higher the probability of an exact match to the query string.

The returned artistId value can be used as a parameter for the Get Artist Detail and Get Artist Routebook endpoints.

Example

To find the first page of artists that match the query string “jay-z”:

https://www.pollstar.com/api/v2/artists/search/jay-z?page=0

Response

{
    "page": 0,
    "pageSize": 20,
    "totalArtists": 3,
    "artists": [
        {
            "artistId": 29784,
            "artistName": "Jay-Z",
            "url": "www.pollstar.com/artist/jay-z-29784",
            "rb": 0,
            "th": 88,
            "bo": 70,
            "genre": "Rap / HipHop",
            "rank": 640.6897
        },
        {
            "artistId": 163300,
            "artistName": "The Throne Feat. Kanye West And Jay-Z",
            "url": "https://www.pollstar.com/artist/the-throne-feat-kanye-west-and-jay-z-163300",
            "rb": 0,
            "th": 0,
            "bo": 0,
            "genre": "",
            "rank": 204.4944
        },
        {
            "artistId": 740661,
            "artistName": "Just Jay-Z",
            "url": "https://www.pollstar.com/artist/just-jay-z-740661",
            "rb": 0,
            "th": 0,
            "bo": 0,
            "genre": "Uncategorized",
            "rank": 194.58072
        }
    ]
}
<root>
    <page>0</page>
    <pageSize>20</pageSize>
    <totalArtists>3</totalArtists>
    <artists>
        <artist>
            <artistId>29784</artistId>
            <artistName>Jay-Z</artistName>
            <url>https://www.pollstar.com/artist/jay-z-29784</url>
            <rb>0</rb>
            <th>88</th>
            <bo>70</bo>
            <genre>Rap / HipHop</genre>
            <rank>640.6897</rank>
        </artist>
        <artist>
            <artistId>163300</artistId>
            <artistName>The Throne Feat. Kanye West And Jay-Z</artistName>
            <url>https://www.pollstar.com/artist/the-throne-feat-kanye-west-and-jay-z-163300</url>
            <rb>0</rb>
            <th>0</th>
            <bo>0</bo>
            <genre></genre>
            <rank>204.4944</rank>
        </artist>
        <artist>
            <artistId>740661</artistId>
            <artistName>Just Jay-Z</artistName>
            <url>https://www.pollstar.com/artist/just-jay-z-740661</url>
            <rb>0</rb>
            <th>0</th>
            <bo>0</bo>
            <genre>Uncategorized</genre>
            <rank>194.58072</rank>
        </artist>
    </artists>
</root>

 

%d bloggers like this: