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