{
"opencollection": "1.0.0",
"info": {
"name": "JamBase Concert Data Artists Venues API",
"version": "3.1.0"
},
"request": {
"auth": {
"type": "bearer",
"token": "{{bearerToken}}"
}
},
"items": [
{
"info": {
"name": "Venues",
"type": "folder"
},
"items": [
{
"info": {
"name": "Search Venues",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.data.jambase.com/v3/venues",
"params": [
{
"name": "page",
"value": "",
"type": "query",
"description": "Page number of results to retrieve"
},
{
"name": "perPage",
"value": "",
"type": "query",
"description": "Number of events per page of results"
},
{
"name": "venueName",
"value": "Brooklyn%20Bowl",
"type": "query",
"description": "A keyword-based search for venue name(s).\n- venueName=Brooklyn%20Bowl\n\nUse a pipe (|) to include multiple venue IDs.\n- venueName=Brooklyn%20Bowl|House%20of%20Blues\n\nFor more precise venue-specific results try using `venueId` or `venue[slug]`.\n"
},
{
"name": "geoCityId",
"value": "jambase:4223296",
"type": "query",
"description": "Use to retrieve events for specific JamBase city ID(s) . \n- geoCityId=jambase:4223296\n\nUse a pipe (|) to include multiple city IDs.\n- geoCityId=jambase:4223296|jambase:4224564\n\nWhen using the `geoCityId` parameter, you can omit the the `geoRadiusAmount` parameter (or) set it to `0` (or) leave it empty to include only results from the city. Else, you can use a radius amount to include events within a radius around the city-center.\n"
},
{
"name": "geoCityName",
"value": "",
"type": "query",
"description": "Use to retrieve events for city name(s).\n- geoCityName=Seattle\n\nUse a pipe (|) to include multiple city names.\n- geoCityName=Seattle|Tacoma\n\nFor more precise city-specific results try using `city[id]`\n"
},
{
"name": "geoCountryIso2",
"value": "",
"type": "query",
"description": "The two-letter ISO code for a country.\n- geoCountryIso2=US\n\nUse a pipe (|) to include multiple countries.\n- geoCountryIso2=US|CA\n"
},
{
"name": "geoCountryIso3",
"value": "",
"type": "query",
"description": "The three-letter ISO code for a country.\n- geoCountryIso3=USA\n\nUse a pipe (|) to include multiple countries.\n- geoCountryIso3=USA|CAN\n"
},
{
"name": "geoIp",
"value": "",
"type": "query",
"description": "Use to retrieve events near an IP address.\\\nSupports IPv4 or IPv6 values.\n- geoIp=55.123.456.789\n"
},
{
"name": "geoLatitude",
"value": "",
"type": "query",
"description": "The latitude for geographic radius.\n- geoLatitude=40.7505\n"
},
{
"name": "geoLongitude",
"value": "",
"type": "query",
"description": "The longitude for geographic radius.\n- geoLongitude=-73.9934\n"
},
{
"name": "geoMetroId",
"value": "jambase:1",
"type": "query",
"description": "Use to retrieve events for specific metro ID(s).\n- geoMetroId=jambase:1\n\nUse a pipe (|) to include multiple metro IDs.\n- geoMetroId=jambase:1|jambase:5\n"
},
{
"name": "geoRadiusAmount",
"value": "",
"type": "query",
"description": "The search radius for lat/lng type searches.\n- geoRadiusAmount=60\n"
},
{
"name": "geoRadiusUnits",
"value": "",
"type": "query",
"description": "Whether to use miles (default) or kilometers for radius.\n- geoRadiusUnits=km\n"
},
{
"name": "geoStateIso",
"value": "",
"type": "query",
"description": "The State code in ISO_3166-2 format [[docs](https://en.wikipedia.org/wiki/ISO_3166-2)].\n- geoStateIso=US-NY\n\nUse a pipe (|) to include multiple State codes.\n- geoStateIso=US-NY|=US-PA\n\nNote: Available for United States, Canada, and Australia only.\n"
},
{
"name": "dateModifiedFrom",
"value": "2022-10-31 00:00:00",
"type": "query",
"description": "Must have been updated on or after this dateTime in GMT.\\\nIf left blank or omitted, will use all updated on dates\n\n- dateModifiedFrom=2022-10-31 00:00:00\n\nNote: Use RFC3339 format for parameter values.\n"
},
{
"name": "datePublishedFrom",
"value": "2022-01-01 00:00:00",
"type": "query",
"description": "Must have been first published on or after this dateTime in GMT.\\\n\\\nIf left blank or omitted, will use all first published on dates.\n\n- datePublishedFrom=2022-01-01 00:00:00\n\nNote: Use RFC3339 format for parameter values.\n"
},
{
"name": "venueHasUpcomingEvents",
"value": "",
"type": "query",
"description": "Set to true to only return venues that have at least one upcoming event"
},
{
"name": "expandExternalIdentifiers",
"value": "",
"type": "query",
"description": "Use `true` to include external IDs for `Concert`, `Artist`, and `Venue` objects.\n\\\nNote: The `expandExternalIdentifiers` parameter requires that your apikey has the `expandExternalIdentifiers` enhancement turned on. Please contact JamBase to request access to this feature.\n"
}
]
},
"docs": "Search venues by location and more.\n\n\n> #### Requirement\n>\n> Your request must include at the `venueName` or at least one of the geo parameters such as `geoCityId`, `geoCountryIso2`, `geoCountryIso3`, `geoIp`, `geoMetroId`, `geoStateIso`, or , `geoLatitude` and `geoLongitude`.\n"
},
{
"info": {
"name": "Get / reverse-lookup a Venue by JamBase or third-party ID",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.data.jambase.com/v3/venues/id/:venueDataSource::venueId",
"params": [
{
"name": "venueDataSource",
"value": "",
"type": "path",
"description": "the VenueDataSource of the ID for the artist"
},
{
"name": "venueId",
"value": "",
"type": "path",
"description": "the unique ID for the Venue"
},
{
"name": "expandUpcomingEvents",
"value": "",
"type": "query",
"description": "Use `true` to include the `event` node with any upcoming Concerts and Festivals for the venue."
},
{
"name": "excludeEventPerformers",
"value": "",
"type": "query",
"description": "Use `true` to suppress the `performer` node in `Concert` and `Festival` objects.\n"
},
{
"name": "expandExternalIdentifiers",
"value": "",
"type": "query",
"description": "Use `true` to include external IDs for `Concert`, `Artist`, and `Venue` objects.\n\\\nNote: The `expandExternalIdentifiers` parameter requires that your apikey has the `expandExternalIdentifiers` enhancement turned on. Please contact JamBase to request access to this feature.\n"
},
{
"name": "expandArtistSameAs",
"value": "",
"type": "query",
"description": "Use `true` to include `sameAs` (i.e. links) for `Artist` responses.\n"
},
{
"name": "expandPastEvents",
"value": "",
"type": "query",
"description": "Use `true` to include past/historical `Concert` and `Festival` objects.\n\\\nWhen searching events, must be combined with `artistId` or `venueId` parameter.\n\\\nNote: The `expandPastEvents` parameter requires that your apikey has the `expandPastEvents` enhancement turned on. Please contact JamBase to request access to this feature.\n"
}
]
},
"docs": "Retrieve a specific venue by JamBase or third-party ID.\n"
}
]
}
],
"bundled": true
}