CHchartmetric
Festival

Festival List

Get Chartmetric's Festival List. Supports filtering by country codes, genre IDs, event-size categories, and name search. Sort by festivalName, rank, startDate (default), numberOfDays, eventSize, score, or totalEditions.

get/api/festival/list

Request

Query parameters

code2s[]string[]

Filter to festivals held in these countries (ISO 3166-1 alpha-2 codes, e.g. ['US', 'GB']).

genreIds[]integer[]

Filter to festivals matching any of these Chartmetric genre IDs.

sortColumn'rank' | 'score' | 'festivalName' | 'startDate' | 'numberOfDays' | 'eventSize' | 'totalEditions'

Column used to sort the festival list. One of rank, score, festivalName, startDate, numberOfDays, eventSize, totalEditions. Defaults to startDate.

sortOrderDescboolean

If true, sort sortColumn in descending order. Defaults to false.

nameSearchstring

Case-insensitive substring filter on festival name.

limitinteger

Maximum number of items to return per request.

offsetinteger

Number of items to skip from the start of the result set; bounded by the public API offset limit.

eventSizes[]string[]

Filter by festival size category. One of small, medium, large, mega.

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.