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
&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>
<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.
