v1

latestSwagger 2.02026-07-13153383.1 KB

/1.0/search/venues

Search for venues.

get/1.0/search/venues

Query parameters

cityIdstring

the city's geoId

cityNamestring

name of the city where the venue is located

countrystring

the city's country

namestring

name of the venue

pinteger

the number of the result page you'd like to have

statestring

the city's state

stateCodestring

the city's state code

Response

Success

totalnumber

the total amount of items matching the query

pagenumber

the current page. starts at 1

itemsPerPagenumber

the amount of items you get per page

Example response

{
  "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
}