Search Artists

Testing

GET

https://insight.lineupiq.io/api/v1/artists

Beta Testing

BETA TESTING

This API is Currently in Closed Beta Testing, If you would like to be included in the closed Beta, please reach out to support.

If there is something specific you would like to see with any of these endpoints, drop a support ticket and let us know!

Request

Query Params

name

string <char>

write-onlyoptional

Search by Artist Name

Example:

Billie Eilish

genres

string <char>

optional

LIst of Comma Separated Strings

Example:

rock,pop

capacity

integer <int32>

write-onlyoptional

Retrieves Artists with a capacity close to the request value.

>= 0<= 1000000

Example:

10000

capacity_range_from

integer <int32>

write-onlyoptional

Requires capacity_range_to if included

>= 0<= 1000000

Example:

1000

capacity_range_to

integer <uint32>

write-onlyoptional

Requires capacity_range_from if included

>= 0<= 1000000

Example:

5000

Header Params

x-app-id

string <password>

required

Default:

x-api-key

string <password>

required

Default:

Content-Type

string

optional

Default:

application/json

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://insight.lineupiq.io/api/v1/artists' \
--header 'x-app-id;' \
--header 'x-api-key;' \
--header 'Content-Type: application/json'

Responses

🟢200OK

application/json

Body

total

integer <int32>

required

Total of the Search Results

results

array [object {6}]

required

integer <int32>

required

ID of the Artist

name

string <char>

required

Name of the Artist

total_events

integer <int32> | null

required

Total Events within the last 12 Months

average_capacity

number | null

required

Calculated Average Capacity of the Artist's events.

gender

enum<string> <char> | enum<null>

required

Gender

Allowed values:

malefemale

Examples:

malefemale

genres

array[string <char> | null]

required

Genres of the Artist

Example

{
  "total": 50,
  "results": [
    {
      "id": "9526070",
      "name": "ABBA Mania",
      "type": "MusicGroup",
      "total_events": 1,
      "average_capacity": 1500,
      "gender": null,
      "genres": [
        "misc",
        "worldwide",
        "others",
        "Undefined",
        "country"
      ]
    },
    {
      "id": "9524394",
      "name": "Emma White",
      "type": "artist",
      "total_events": 10,
      "average_capacity": 300,
      "gender": null,
      "genres": [
        "country",
        "baltimore indie",
        "pop",
        "mainstream pop",
        "indie"
      ]
    },
    {
      "id": "9522466",
      "name": "Amanda Kate",
      "type": "attraction",
      "total_events": 24,
      "average_capacity": 0,
      "gender": null,
      "genres": [
        "country"
      ]
    },
    {
      "id": "9524654",
      "name": "Adam Hood",
      "type": "MusicGroup",
      "total_events": 4,
      "average_capacity": 265,
      "gender": null,
      "genres": [
        "texas country",
        "country",
        "folk",
        "country-music",
        "pop",
        "alt country",
        "world-music",
        "Rock",
        "red dirt",
        "americana",
        "Other"
      ]
    },
    {
      "id": "9524901",
      "name": "Carly Simmons",
      "type": "MusicGroup",
      "total_events": 0,
      "average_capacity": 0,
      "gender": null,
      "genres": [
        "country"
      ]
    },
    {
      "id": "9000563",
      "name": "Long Haul Paul",
      "type": "person",
      "total_events": 0,
      "average_capacity": 0,
      "gender": null,
      "genres": [
        "country",
        "contemporary country"
      ]
    }
  ]
}

🟠422Invalid Parameters

🟠422Missing Parameters

🟠404Record not found

🟠401Unauthorized

🟠403Forbidden

Artists

Get a Specific Artist