Search Performers

Search Performers

GET

Search Performers

Search for performers based on a set of criteria.

Resource URL

https://api.stubhub.com/ /partners/search/performers/v3/

Query Parameters


Name Values Description
id

one or more performer ids to search. (ie. id=123 |456) NOTE: there is a space between the ID and the | but no space between the ID following the | delimeter. The limit for all the ids is 200

q

search by keyword

name

search by performer name

groupingId

filter by grouping id (including children grouping if any), data type is long. secondary grouping id was also included.

groupingName

filter by grouping name(including children grouping if any), data type is string.

categoryId

search by categoryId for example to filter concert categories (1) and NOT festivals (490277): cateegoryId=1 -490277

categoryName

search by categoryName

status

The status of the performer. Valid statuses are: Active, Inactive, Deleted, Draft, Review, Closed, Restricted

point

Spatial search by lat-lon and radius, data type is String, lat-long is concated using comma, e.g. point=34.7452778,-92.3275

radius

spatial search by lat-lon and radius, data type is double. e.g. 20 or 32.1869

unit

radius units, supported values: mi, km

hidden

If need to include hidden performers, value will be true of false. true means include hidden performers

externalSource

Performer external source, supported values: spotify, itunes, zvents, rovi, mediaNet,amg, espn, Worked with id together

start

return results starting from the specified index.

rows

max results to return, max=500.

sourceId

Performer Provider. Supported values -1-All, 0-Unified,1-StubHub,2-Zvents,3-MediaNet,4-AMG

ir

If need to use image randomization, value will be true or false, true means to use image randomization

sort

**Optional Parameter**. A pair of space-separated tokens that specifies how the performers are sorted. - First token identifies property of the performer for sorting. For the first token, you can specify any one of the following properties: `name`, `status`, `popularity`, `localPopularity`, `distance`,`createdDate` , `eventCount` - Second token specifies the direction of the sort. For the second token, you can specify one of the following types - `asc` for ascending order, `desc` for descending order Syntax: `property asc` or `property desc` If you do not provide this parameter. the default is the listings are sorted by name in ascending order (`sort=name asc`) You can also sort multiple fields with a statement like this: `sort=name asc, popularity desc` Examples: - Single Value Sort: `sort=name desc` to sort the performer in their descending order of name. - Multiple Values Sort: `sort=name asc, popularity desc, eventCount asc` In this example, the parameters are sorted in the following order: - By name (in ascending order); - If any performer have the same name, then they are sorted by popularity (in descending order); - If any performer are identical in both name and popularity, then they are sorted by the eventCount (in ascending order).

fieldList

The list of fields to be displayed in the response. This parameter can be used if you would like to fetch only a subset of the default response. Allowed values are: numFound, id, status, name, description, url, categories, groupings, ancestors, aliases, displayAttributes, popularities, images, eventCount, score, createdDate, distance, performerAttributes, catalogAttributes


Header Parameters


Name Values Description
Authorization
(required)

To generate an access token, use the [generateToken API](https://developer.stubhub.com/oauth/apis/post/accesstoken). Note that you will need to add a 'Bearer ' prefix to your access token. Otherwise, you'll get an 'Invalid Access Token' error

Accept
(required)

application/json

Request Body

HTTP Basic

OAuth 2.0

API Key

Reset

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Response Error Details

  • HTTP Code
    Error Code
    Description
  • 404

    Resource Not Found. If the requested entity is not available, this status is returned.

  • 401

    Not authorized to access the listing

  • 403

    Forbidden

  • 400

    Bad request

Resource Summary

Security

Content Type

application/json

Working...