Page Comparison

Page Properties

label	api_docs_venues

Name	Venues Index
Description	List all venues conforming to passed parameters.
Type	GET
URL	/v9/venues

...

Name	Description	Value Type	Required
name	Exact name of the venue	String	Optional
popularity_score	Venue's popularity rating	decimal	Optional
disabled_at	Date/time venue was disabled	Date	Optional
deleted_at	Date/time venue was deleted	Date	Optional
updated_at	Date/time venue was updated	Date	Optional
first_letter	Filters venues by the first letter passed	Char	Optional
lat	Latitude of venue (requires corresponding lon)	Decimal	Optional
lon	Longitude of venue (requires corresponding lat)	Decimal	Optional
ip	Infer lat and lon by location of IP Address	String	Optional
postal_code	Infer lat and lon by location of postal code	String	Optional
city_state	Infer lat and lon by location of city and state	String	Optional
within	Radius from lat and lon to search (default 15)	Integer	Optional
order_by	Pass in the parameter that you want to order by and the sorting order (Ex. :order_by => "venues.popularity_score DESC")	String	Optional

Examples

Request

Response

/v9/venues?lat=40.7281&lon=-74.0781&within=1

Code Block

theme	Confluence
language	ruby

{
   "current_page":1,
   "total_entries":2,
   "venues":[
      {
         "upcoming_events":{
            "last":"2013-01-27 14:00:00",
            "first":"2010-12-04 19:00:00"
         },
         "address":{
            "locality":"Jersey City",
            "postal_code":"07306",
            "label":null,
            "country_code":"US",
            "street_address":"Saint Peters College",
            "created_at":"2012-04-12 03:37:53.735782",
            "latitude":"40.7272951338493",
            "extended_address":"Kennedy Boulevard",
            "location":"Jersey City, NJ",
            "longitude":"-74.0707141693115",
            "region":"NJ"
         },
         "popularity_score":"0.000000",
         "keywords":null,
         "country_code":"US",
         "url":"/venues/9114",
         "updated_at":"2012-10-01 18:00:39.221713",
         "location":"Jersey City, NJ",
         "name":"Yanitelli Center",
         "id":9114
      },
      {
         "upcoming_events":{
            "last":"2011-11-06 08:00:00",
            "first":"2011-11-06 08:00:00"
         },
         "address":{
            "locality":"Jersey City",
            "postal_code":"07306",
            "label":null,
            "country_code":"US",
            "street_address":"54 Journal Square",
            "created_at":"2012-04-12 03:37:55.198502",
            "latitude":"40.7320659",
            "extended_address":null,
            "location":"Jersey City, NJ",
            "longitude":"-74.0641019",
            "region":"NJ"
         },
         "popularity_score":"0.000000",
         "keywords":"",
         "country_code":"US",
         "url":"/venues/4586",
         "updated_at":"2012-05-24 15:20:27.697444",
         "location":"Jersey City, NJ",
         "name":"Landmark Loews Jersey Theatre",
         "id":4586
      }
   ],
   "per_page":100
}

Versions Compared

Old Version 3

New Version 4

Key

Examples