Search for venues

This function looks for venues fulfilling specified criteria.

Arguments:

  • auth or (user, password)

    This method requires authentication. See authentication

  • keywords (option)

    Keywords that the function will search in the venue's name and address.

  • venue_name (option)

    Venue Name.

  • street (option)

    Venue street Name.

  • city (option)

    City Name.

  • country (option)

    Country Name.

  • zip (option)

    Venue Zip code.

  • sort_by (option)

    Sort results by (default is by relevance):

    • venue_name
    • city
    • country

  • sort_direction (option)

    Sort results ascending or descending (ascending by default).

    • ascending
    • descending

  • venue ID (option)

    Venue ID.

Example Request URL:

http://www.findevent.com/api/request/See authentication
&function=search_venue
&keywords=arena
&country=Canada
&sort_by=city

Response Parameters:

A resposta é um bloco XML regular.

  • num_venues

    Total number of venues found.

  • venue

    All information about a found venue is contained here.

  • id

    Unique id of the venue.

  • url

    Url to this venue on Findevent.

  • name

    Venue Name.

  • street_address

    Venue street Name.

  • city

    City Name..

  • state

    The venue state.

  • country

    Country Name..

  • zip

    Venue Zip code.

  • venue_url

    Url to the website of the venue.

  • phone

    Phone number.

  • longitude

    Venue longitude in degrees.

  • latitude

    Venue latitude in degrees.

Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<search_results>
   <num_venues>3</num_events>
   <venues>
      <venue>
         <id>25987</id>
         <url> http://www.findevent.com/venues/25987/Little_Fish_Theatre</url>
         <name>Little Fish Theatre</name>
         <street_address>777 Centre St</street_address>
         <city>San Pedro</city>
         <state>California</state>
         <country>United States</country>
         <zip>90731</zip>
         <venue_url>http://www.littlefishtheatre.org/</venue_url>
         <phone>310 512 6030</phone>
         <longitude>-118.28405</longitude>
         <latitude>33.737184</latitude>
      </venue>
   </venues>
</search_results>

Possible Errors

  • Missing parameter either (keywords, venue_name, date, city, country, or type) must be nonempty.

Featured

Los Angeles Fashion Week

Los Angeles Fashion Week takes place each March (for fall collections) and October (for spring collections) in locations throughout the Los Angeles Area. It started in the middle of the 20th century w...

find out more!