Talent API

API Endpoint

ShowClix provides a simple API to get Talent information that we host about talents in our events.

You will need to know the talent service provider ID to begin. Every talent also has their own unique identifier.

Talent APIs

Talent JSON

GET /api/talent/json
Requestsexample 1
Headers
Content-Type: application/x-www-form-urlencoded
Body
service=1&talent_id=123456
Responses200
Headers
Content-Type: application/json
Body
{
  "identifier": "123456",
  "availableSocial": {
    "twitter": "https://twitter.com/12345",
    "facebook": "https://www.facebook.com/12345",
    "instagram": "https://www.instagram.com/12345",
    "spotify": "https://open.spotify.com/artist/12345",
    "youtube": "https://www.youtube.com/channel/12345",
    "soundcloud": "https://www.soundcloud.com/12345"
  },
  "smallImage": "https://media.example.com/images/12345/landscape/1x1/small1.jpg",
  "mediumImage": "https://media.example.com/images/12345/landscape/16x9/medium1.jpg",
  "landscapeImage": "https://media.example.com/images/12345/landscape/16x9/1.jpg",
  "availableVideo": "true",
  "description": "Lorem Ipsum",
  "featuredVideo": [
    {
      "id": "####",
      "name": "Song Title",
      "url": "https://www.youtube.com/watch?v=#####",
      "isFeatured": "true",
      "videoId": "#####",
      "embed": "https://www.youtube.com/embed/#####"
    }
  ]
}

Get a Talent JSON
GET/api/talent/json

Request Attributes

Property Type Required Notes
service string always identifier of the talent service provider
talent_id string always identifier of the talent information requested

Response Attributes

Property Type Notes
identifier string talent identifier matching the request talent_id
name string name of the talent
availableSocial object object with social network links: “twitter”, “facebook”, “instagram”, “spotify”, “youtube”, “soundcloud”
availableVideo boolean does this talent have videos
description string description/bio of the talent
smallImage string small square image of the talent
mediumImage string large 16x9 image of the talent
landscapeImage string small 16x9 image of the talent
featuredVideo object object with video information for the talent: “id”, “name”, “url”, “isFeatured”, “videoId”, “embed”

Generated by aglio on 07 May 2024