Discover festivals filtered by audience metrics, capacity, activity status, or metadata attributes.
Name
discover_festivals
Schema
Properties
| Name |
Description |
Example |
| platform |
Platform used for ranking festivals. Use platform "soundcharts" with metric "score" to retrieve the global festival ranking |
soundcharts |
| metric |
Metric used to rank festivals |
score |
| period |
Time period used for growth ranking |
week |
| country |
Optional country code used to filter festivals by territory. Use ISO 3166-1 alpha-2 country codes, for example "US" or "FR". |
FR |
| genre |
Music genre used to filter festivals. Use the list_song_music_genres tool to retrieve available genres. |
hip hop |
| isActive |
Filter festivals by activity status. Set to true to retrieve active festivals only. |
|
| capacityMin |
Minimum festival capacity used for filtering. |
0 |
| capacityMax |
Maximum festival capacity used for filtering. |
10000 |
| sortBy |
Sort festivals by latest total value, absolute growth or percentage growth |
total |
| sortOrder |
Sort direction |
desc |
| limit |
Maximum number of items to return. |
|
| cursor |
Pagination cursor returned by a previous call. Use it to retrieve the next page of results. |
|
Required