.
.

Search API

Request:

Name Method Description
/v1/search/venue GET Search for venue

General Search Parameters

Name Data Type Opt/Req Description
term string optional Search term (ie. "food", "fish"). If term is empty the search will return all results.
limit int optional Number of results returned. Currently limited to a maximum of 50. [default: 10]
offset int optional Offset the list of results by this amount
price int optional Price filter. See list of prices.
cuisine string optional Cuisine filter. See list of cuisine.
category string required Category filter. See list of categories. (use "All" for any category)
disabledaccess bool optional return venues with disabled access
wifi bool optional return venues with wifi
viewcard bool optional return venues with View Card offers
hasrestaurantbooking bool optional return venues with table booking functionality
bb_nelat double optional Latitude of northwest corner of boundbox
bb_nelng double optional Longitude of northwest corner of boundbox
bb_swlat double optional Latitude of southeast corner of boundbox
bb_swlng double optional longitude of southeast corner of boundbox
vwsid string required api key

Location Parameters

The following parameter is required. All results are sorted by distance from this specified latitude and longitude.

latlng=latitude,longitude
Name Data Type Opt/Req Description
latitude double required Latitude of geo-point to search near
longitude double required Longitude of geo-point to search near

Response:

Name Data Type Description
total int Total number of results
venues list List of venue objects (see venue)

Venue

Name Data Type Description
id int Venue id
name string Name of venue
image_url string Url for venue image
url string Url for venue page on View
telephone string Telephone number for venue
location object Location data for venue
location.lat double Latitude of venue
location.lng double Longitude of venue
location.address string Formatted venue address. Includes all address fields
location.city string City
location.postcode string Postcode
location.areas int cityid
location.cityid int Venue id
user_review_count int Total number of user reviews for this venue.
user_review_avgscore int Average user score for the venue
review_score int Editorial review score for the venue (0 if no review or score)
distance double Distance in metres from search location
viewcard bool Indicates if the venue has view card offers
recommended bool Indicates if the venue is recommended
categories list list of strings for venue categories
disabledaccess bool indicates if venue has disabled access
disabletoilets bool indicates if venue has disabled toilets
openhours string opening hours of venue
acceptscards bool indicates if the venue accepts credit cards
acceptedcards list list of credit cards (strings)
tubes list list of tube stations near to venue

Example

Sample Request:

Sample Response:

  • {
    • "venues":[
      • {
        • "id":"278555",
        • "name":"B-Soho",
        • "image_url":"http://cdn.view.co.uk/upload/venues/BSohoW1_150.jpg",
        • "url":"http://www.viewlondon.co.uk/pubsandbars/b-soho-info-278555.html",
        • "telephone":"(020) 7287 1661",
        • "location":{
          • "lat":51.51507,
          • "lng":-0.13730764,
          • "address":"21-22 Poland Street, Soho, London, W1F 8QQ",
          • "city":"London",
          • "postcode":"W1F 8QQ",
          • "areas":[
            • "Soho, Chinatown & Leicester Square"
          • ],
          • "cityid":25
        • },
        • "user_review_count":5,
        • "user_review_avgscore":4,
        • "distance":278,
        • "viewcard":false,
        • "recommended":true,
        • "categories":[
          • "Pubs & Bars",
          • "Restaurants"
        • ],
        • "disabledaccess":true,
        • "disabledtoilets":false,
        • "openhours":"Mon-Sat 11:00-00:00<br>\nSun closed",
        • "acceptscards":true,
        • "acceptedcards":[
          • "American Express",
          • "Delta",
          • "Maestro",
          • "Mastercard",
          • "Visa",
          • "Visa Electron"
        • ],
        • "tubes":[
          • "Oxford Circus",
          • "Tottenham Court Road"
        • ]
      • }
    • ],
    • "total":263
  • }