AI-Powered Artist Discovery API

Creates an AI-driven artist recommendation for a specific venue based on event details and audience preferences. This endpoint helps optimize booking decisions by predicting high-performing artists.

Request

Header Params

Content-Type

string

optional

Example:

application/json

x-app-id

string <password>

required

Default:

x-api-key

string <password>

required

Default:

Body Params application/json

venue_name

string

required

Name of the Venue that will be holding the event

Example:

Union Hall

venue_id

integer

optional

LineupID of the Venue that will be holding the event

Example:

8000000

venue_capacity

integer

required

Venue's Total Capacity

Example:

3000

event_date

string <date-time>

required

Proposed Event Date

lat_long

string

optional

The Venues's Latitude and Longitude as a string

Example:

-44.84011, 153.55179

address

string

optional

The Venue's Primary Street Address

Example:

6240 99 Street Northwest

city

string

optional

The Venue's City

Example:

Edmonton

region_code

string

optional

The Venue's Region Code (ISO 3166‑2)

>= 2 characters<= 6 characters

Examples:

ABCA

country_code

string

optional

The Venues Country Code (ISO 3166-1 alpha-2)

>= 2 characters<= 2 characters

Examples:

CAUS

postcode

string

optional

The Venue's Postal Code/Zipcode

>= 5 characters<= 8 characters

Examples:

T6E 6C990210

genres

array[string]

required

Example

{
  "venue_name": "The Great Hall",
  "venue_id": 8000000,
  "venue_capacity": 1200,
  "lat_long": "53.499, -113.486",
  "address": "6222 199 Street Northwest",
  "city": "Edmonton",
  "region_code": "AB",
  "country_code": "CA",
  "postcode": "T6E 6D9",
  "genres": [
    "country"
  ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

status

enum<string> <char>

read-onlyrequired

Status of the Request

Allowed values:

SUCCESSFAILED

Examples:

SUCCESSFAILED

request_id

string <uuid>

required

Unique Identifier of the Request

Example:

62ff278c-cc6d-48a6-9969-fb2b3c1755ec

data

array [object {5}]

required

Response Data

artist_name

string

required

Artist Name

Examples:

Brett KisselBillie Eilish

artist_id

integer <int32>

required

LineupIQ Identifying the Artist

Examples:

90299619017831

rank

integer <int32>

required

The Rank of the Artist in the List based on our Algorithm

>= 1<= 500

Examples:

12345

average_capacity

integer

required

The calculated average capacity based on the artist's previous events

Examples:

21544120005000

genres

array[string]

required

requester

object

required

name

string

read-onlyrequired

The Requester's Name (You'r Name)

Examples:

John SnowKaren SmithJohn Doe

string

required

The Requester's Email (Your Email)

app_id

string <uuid>

read-onlyrequired

The Requester's app_id (x-app-id value)

Example:

e647ae88-70a2-4bf5-9e3e-405635d1bed4

Examples

SuccessValidation Error

{
  "status": "SUCCESS",
  "request_id": "62ff278c-cc6d-48a6-9969-fb2b3c1755ec",
  "data": [
    {
      "artist_name": "George Strait",
      "artist_id": 9024880,
      "rank": 1,
      "average_capacity": 61127,
      "genres": [
        "country-music",
        "country",
        "world-music"
      ]
    },
    {
      "artist_name": "Diamond Dixie",
      "artist_id": 9390532,
      "rank": 2,
      "average_capacity": 61500,
      "genres": [
        "country"
      ]
    },
    {
      "artist_name": "CMAT",
      "artist_id": 9528424,
      "rank": 3,
      "average_capacity": 39732,
      "genres": [
        "country-music",
        "Pop",
        "indie",
        "country"
      ]
    },
    {
      "artist_name": "Cross Canadian Ragweed",
      "artist_id": 9018384,
      "rank": 4,
      "average_capacity": 53885,
      "genres": [
        "country-music",
        "country",
        "world-music"
      ]
    },
    {
      "artist_name": "Hillary Scott & The Scott Family",
      "artist_id": 9025153,
      "rank": 5,
      "average_capacity": 41444,
      "genres": [
        "ccm",
        "gospel",
        "country",
        "worship",
        "christian country",
        "christian"
      ]
    },
    {
      "artist_name": "Chris Shiflett",
      "artist_id": 9123466,
      "rank": 6,
      "average_capacity": 35958,
      "genres": [
        "americana",
        "world-music",
        "country-music",
        "pop",
        "country",
        "rock"
      ]
    },
    {
      "artist_name": "Madeline Edwards",
      "artist_id": 9045168,
      "rank": 7,
      "average_capacity": 7835,
      "genres": [
        "country-music",
        "country",
        "world-music",
        "other",
        "pop"
      ]
    },
    {
      "artist_name": "Charlie Cope",
      "artist_id": 9107551,
      "rank": 8,
      "average_capacity": 46000,
      "genres": [
        "country"
      ]
    },
    {
      "artist_name": "Jaron Bell",
      "artist_id": 9105802,
      "rank": 9,
      "average_capacity": 70000,
      "genres": [
        "texas country",
        "red dirt",
        "country"
      ]
    },
    {
      "artist_name": "Amy Clawson",
      "artist_id": 9031844,
      "rank": 10,
      "average_capacity": 64100,
      "genres": [
        "country"
      ]
    }
  ],
  "requester": {
    "name": "Joe Blow",
    "email": "joe@blow.com",
    "app_id": "62ff278c-cc6d-48a6-9969-fb2b3c1786ec"
  }
}

🟠422Validation Error

🟠401Unauthorized

🔴500Server Error

🟢200OK

Generate New Discovery

Request

Request samples

Responses