Skip to main content

​
Get Artist Products

GET /api/v2/artists/75692/1
Retrieve a paginated list of products associated with a specific artist.

​
Path Parameters

​
slug
integer
required
Artist ID (note: this is called “slug” in the path but expects an integer artist ID)
​
page
integer
required
Page number for pagination (starts at 1)

​
Request Body (POST)

You can also POST to this endpoint with filter options:
​
sort
integer
default:"1"
Sort order for products:
  • 0: Sort alphabetically by product name
  • 1: Default sort (by category_search_sort and sort_order)
  • 2: Sort by newest (target_date descending)
  • 3: Sort by price (low to high)
  • 4: Sort by price (high to low)
  • 5: Sort alphabetically by product name
​
cats
array
Array of category IDs to filter artist products by category

​
Response

​
totalPages
integer
Total number of pages available
​
products
array
Array of product objects for this artist

​
Pagination Details

  • Page Size: 18 products per page
  • Products are filtered by added_by field matching the artist ID
  • In-stock products appear first, followed by sold-out items
  • Default sort: by category_search_sort ascending, then sort_order ascending

​
Filtering

When cats array is provided:
  • Products are filtered to only those in the specified categories
  • Sort order remains: souled_out → category_search_sort → sort_order

​
Get Artist Details

GET /api/v2/artist/harry-potter
Retrieve detailed information about a specific artist.

​
Path Parameters

​
slug
string
required
Artist URL key/slug

​
Query Parameters

​
platform
string
Platform identifier:
  • web: Web platform (action_source = 1)
  • Other values: Mobile/app (action_source = 2)

​
Response

​
id
integer
Artist ID
​
firstname
string
Artist name
​
url_key
string
Artist URL slug
​
profile_pic
array
Array of artist profile picture URLs
​
cover_pic
array
Array of desktop cover image URLs
​
mobile_cover_pic
array
Array of mobile cover image URLs
​
art_status
integer
Artist status
​
is_merch
integer
Whether this is official merchandise (1 = yes, 0 = no)
​
sale_start_date
string
Sale period start date (format: YYYY-MM-DD HH:MM:SS)
​
sale_end_date
string
Sale period end date (format: YYYY-MM-DD HH:MM:SS)
​
sale_cover_pic
string
Desktop cover image during sale period (JSON string)
​
sale_mob_cover_pic
string
Mobile cover image during sale period (JSON string)
​
event_id
string
Facebook pageview event ID (web platform only)

​
Image Handling

  1. Profile Pictures: JSON-parsed array of image URLs
  2. Cover Images: JSON-parsed arrays of desktop and mobile cover images
  3. Sale Period Images: During sale period (between sale_start_date and sale_end_date):
    • cover_pic is replaced with sale_cover_pic
    • mobile_cover_pic is replaced with sale_mob_cover_pic
  4. Timezone: Date comparisons use Asia/Kolkata timezone

​
Error Responses

  • 404 Not Found: Artist slug doesn’t exist

​
Get Artist Listing

GET /api/v2/product-listing-artist
Retrieve a complete listing of artists with official merchandise, including their tags.

​
Response

​
artists
array
Array of artist objects
​
artist_filter_tags
array
Unique list of all tags used across all artists

​
Implementation Details

  • Only returns artists where is_merch = 1 (official merchandise)
  • Tags are fetched from the tagging_tagged table where taggable_type = 'User'
  • Each artist includes their associated tags for filtering
  • Results include a global list of all unique tags for filter UI
  • Results are cached in short-term cache

​
Get Superstar Listing

GET /api/v2/superstars
Retrieve a listing of superstar categories (typically WWE wrestlers or entertainment figures).

​
Query Parameters

​
platform
string
Platform identifier for analytics tracking

​
Response

​
data
array
Array of superstar category objects
​
event_id
string
Facebook pageview event ID (web platform only)

​
Implementation Details

  • Returns categories where parent_id = 344 (superstar parent category)
  • Only active categories (is_active = 1)
  • Limited to 200 results
  • Sorted by sort_order
  • Results are cached in long-term cache

Build docs developers (and LLMs) love

Get started for freeTalk to us