This method allows any authenticated user to search the database for venues. At least one of the following four fields must be supplied: venue_name, address, town, postcode. Additionally, region and country fields can be provided if desired, but neither of these fields is necessary.
Searches are case insensitive, and partial matches are allowed for venue_name, postcode and address but not for the other fields. For example, 'finch' in the address field will match 'Finchley Road' in the address1 field of a record, but 'london' in the region field will not match 'Greater London'.
A maximum of 100 results will be returned for each search.
| Required Arguments | |
|---|---|
| user_email | For authentication |
| user_password | For authentication |
| Optional Arguments (at least one must be provided) | |
|---|---|
| venue_name | Name of venue |
| address | Address of venue (will be matched against both address fields) |
| town | Town |
| postal_code | Postcode/Zipcode |
| Optional Arguments (none required) | |
|---|---|
| region | County, state or region |
| country_code | Country in uppercase ISO 3166-1 Alpha-2 format |
| pending | if value is 1 then only pending venues will be searched |
| extra | if value is 1, enables extra output and address, town, postal_code fields are included in results |
http://api.ives.info/rest/venues/search?user_email=user@domain.com&user_password=fak3passw0rd&venue_name=electric
Errors will be returned in the form of an error document.
Sample XML Output<?xml version="1.0" encoding="UTF-8"?>
<search>
<total_items>2</total_items>
<venues>
<venue id="http://ives.info/gb/4d5rr">
<venue_name>Electric Ballroom</venue_name>
<latitude>51.5397</latitude>
<longitude>-0.143</longitude>
</venue>
<venue id="http://ives.info/gb/knb7k">
<venue_name>Electric Cafe</venue_name>
<latitude>53.9485</latitude>
<longitude>-0.8763</longitude>
</venue>
</venues>
</search>