AI-Powered Artist Match Lookup

Fetches detailed AI predictions for a specific discovery request, including ranked artist recommendations, genres, and audience insights.

Request

Path Params

request_id

string

required

Example:

e079a634-86bd-4029-b6a4-ba2a0cd82601

Query Params

type

enum<string> <char>

optional

Response Type: Simple return a lightweight response including Top Level Artist details, Rank and Tags. Detailed returns the full response including all events, ranks, genres, and artist details.

Allowed values:

simpledetailed

Default:

simple

Example:

simple

include

enum<string> <char>

write-onlyoptional

Eager Load Specific items in the response

Allowed values:

eventstagsspotify

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

Responses

🟢200Success (Simple)

application/json

Body

request_id

string <uuid>

read-onlyrequired

Unique Identifier of the Request

Example:

e08b680a-86c6-4d37-8dfb-981f2aa754c1

timestamp

string <date-time>

read-onlyrequired

Created Timestamp

Example:

2025-02-05T02:58:56.405994+00:00

venue_id

integer <int32>

optional

Lineup ID of the Venue

Example:

8000000

venue_name

string <char>

required

Name of the Venue

Example:

Union Hall

venue_capacity

integer

required

Capacity of the Venue

lat_long

string <char>

optional

Coords of the Venue as a string

Example:

53.499, -113.486

address

string <char>

optional

Venue Address

Example:

1234 Somestreet SW

city

string <char>

optional

City Name

Example:

Someville

region_code

string <char>

optional

ISO-3166-2 Region Code

Examples:

ABBCCAFL

country_code

string <char>

optional

ISO-3166-2 Country Code

Examples:

USCA

postcode

string <char>

optional

Venue Postal/Zipcode

Examples:

23464X1X 1X1

genres

array[string <char>]

required

artists

array [object {6}]

required

artist_id

integer

optional

Lineup ID for the Artist (integer)

artist_name

string

optional

Artist Name

tags

array[string <char>]

optional

Array of Tags applied during calculation

average_capacity

integer <int32>

read-onlyoptional

Artists Calculated Average Capacity

Examples:

120034000

genres

array[string <char>]

optional

type

string <char>

optional

Artist Classification

Examples:

ArtistMusicGroupBand

requester

object (Requester Object)

required

Requester Details

name

string <char>

read-onlyrequired

Requester Full Name

Default:

John Snow

Examples:

John SnowJane Doe

string <email>

required

Requester's Email Address

Example:

john.snow@gmail.com

app_id

string <uuid>

read-onlyrequired

Requester's app_id from the Header of their request

Default:

c65993a5-35ef-4934-af6b-38d2a8ce8b03

Example:

c65993a5-35ef-4934-af6b-38d2a8ce8b03

Example

{
  "venue_id": 8000000,
  "venue_name": "Union Hall",
  "venue_capacity": 8955905755005401,
  "lat_long": "53.499, -113.486",
  "address": "1234 Somestreet SW",
  "city": "Someville",
  "region_code": "FL",
  "country_code": "CA",
  "postcode": "X1X 1X1",
  "genres": [
    "pop"
  ],
  "artists": [
    {
      "artist_id": 6740923203292642,
      "artist_name": "Rosemary Clooney",
      "tags": [
        "1stPlace",
        "TopSpotifyFollowers"
      ],
      "genres": [
        "country",
        "electronic"
      ],
      "type": "MusicGroup"
    },
    {
      "artist_id": 3565054261437794,
      "artist_name": "C. Tangana",
      "tags": [
        "TopSpotifyFollowers",
        "2ndPlace"
      ],
      "genres": [
        "country",
        "pop"
      ],
      "type": "MusicGroup"
    }
  ],
  "requester": {
    "email": "john.snow@gmail.com"
  }
}

🟢200Success (Detailed)

🟠404Record not found

🟠422Invalid input

🟠401Unauthorized

🟠403Forbidden

Get a Specific Discovery

Request

Request samples

Responses