Discover venues filtered by audience metrics, capacity, activity status, or metadata attributes. Available only for premium Soundcharts API subscriptions.
Name
discover_venues
Schema
Properties
| Name |
Description |
Example |
|
platform
|
Platform used for ranking venues. Use the list_venue_social_platforms tool to retrieve supported platforms. Use platform "soundcharts" with metric "score" to retrieve the global venue ranking.
|
spotify
|
|
metric
|
Metric used to rank venues. The metric "score" can be used with platform "soundcharts" to retrieve the global venue ranking.
|
followers
|
|
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_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 (default 10, max 500).
|
|
|
cursor
|
Pagination cursor returned by a previous call. Use it to retrieve the next page of results.
|
|
Required
| Name |
|
platform
|
|
metric
|
|
sortBy
|
|
sortOrder
|