/1.0/search/venues Resource

GET /1.0/search/venues

Search for venues.

Request Parameters
name type description default constraints
cityId query the city's geoId    
cityName query name of the city where the venue is located    
country query the city's country    
name query name of the venue    
p query the number of the result page you'd like to have 1 int
state query the city's state    
stateCode query the city's state code    
Response Body
media type data type description
application/json venues (JSON) a list of matching venues
application/xml venues (XML)

Example

Request
GET /1.0/search/venues
Accept: application/json

              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "venue" : [ {
    "city" : {
      "id" : "5357527",
      "name" : "Hollywood",
      "stateCode" : "CA",
      "state" : "California",
      "coords" : { },
      "country" : { }
    },
    "url" : "https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html",
    "id" : "6bd6ca6e",
    "name" : "Compaq Center"
  }, {
    "city" : {
      "id" : "...",
      "name" : "...",
      "stateCode" : "...",
      "state" : "...",
      "coords" : { },
      "country" : { }
    },
    "url" : "...",
    "id" : "...",
    "name" : "..."
  } ],
  "total" : 42,
  "page" : 1,
  "itemsPerPage" : 20
}