Method: /event_recent

Display recently created events.

Invocation

Request Parameters

Parameter Description Type Extra
where A string describing a location around which the recent events will be restricted. (e.g., san francisco, ca or 94131). You can also specify a location using a longitude/latitude coordinate pair using the notation -74.0:BY:40.9

 String optional
radius The number of miles around the location (specified in the where field) to include. If this field is left blank, a default radius is supplied. The default radius varies according to the location specified in the where field. Float optional
limit The maximum number of matching events to return. The default is 5 and maximum is 10. Zvents partners can exceed the maximum. Integer optional
offset The number of events to skip from the beginning of the results. Defaults to 0. Integer optional

Example Request

Response Parameters

The response lists events matching the search terms.

Parameter Description Type Mandatory
id The unique ID for the event. Integer Y
name The name of the event. String Y
summary A summary of the event. String
description A full description of the event. String
link The URL for this event on www.zvents.com. String Y
url The external web page for the event. String
external urls A list of additional external urls associated with this event (e.g., a link to a performer's web page). String List
phone The phone number for the event. String
starttime The starttime of the event. (format YYYYMMDDHHMM) Integer Y
endtime The endtime of the event. (format YYYYMMDDHHMM) Integer
creator_id The ID of the user that created the event. Integer Y
price The price of the event (if available). String
age suitability Age suitability for this event if one was supplied by the event creator. Possible values are All Ages, Kids and up, Teens and up, 18 and up, 21 and up, Senior Citizens, None Specified. String
venue_id The ID of the venue at which the event occurs. Integer Y
parent_id If this event is part of a repeating series, this field provides the ID of the event that is the parent of the repeating series. Note that the ID may point to the current event. Integer
images If this event has images, this field provides a list of URLs for those images. String List
tags A list of tags associated with this event. String List
performers A list of performers appearing at this event. String List
categories A list of categories associated with this event. String List
series_count The number of events in the repeating series that match this search. This value is non-zero only if the event belongs to a repeat series (and multiple events within that series match the search) and the trim option (see above) has been enabled. Integer

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<rsp status="ok">
  <stream_count>1</stream_count>
  <event id="154927">
    <name>Sunday Jazz Series at the Improv: Aaron Lington Quintet</name>
    <description>
      Since his arrival to the Bay Area to take the position of Coordinator
      of Jazz Studies at San Jose State University, Dr. Lington Has quickly
      become a mainstay of the local jazz scene. A recent graduate of North
      Texas State University, he has performed with several well-known artists:
      Maria Schneider and the Temptations to name a few, and arranged and
      composed for legendary trumpeter Maynard Ferguson and vocalist Jamie
      Davis. Dr. Lington also serves as Director of the San Jose Jazz Society
      Orchestra and Youth Jazz Orchestra. Listening samples online at
      www.aaronlington.com
      ---sanjosejazz.org
    </description>
    <summary></summary>
    <url>http://sanjosejazz.org/events.html</url>
    <starttime>200603121500</starttime>
    <endtime>200603121700</endtime>
    <creator_id>3</creator_id>
    <price/>
    <venue_id>4553</venue_id>
  </event>
  <venue id="4553">
    <name>Improv Comedy Club and Restaurant</name>
    <description></description>
    <phone>(408) 280-7475</phone>
    <link>http://www.zvents.com/venues/show/4553</link>
    <url>http://improv2.com/v3/index.php?option=content&task=blogcategory&id=40&Itemid=50</url>
    <creator_id>2</creator_id>
    <address>62 S. 2nd St.</address>
    <city>San Jose</city>
    <zipcode>95113</zipcode>
    <state>California</state>
    <country>United States</country>
    <timezone>US/Pacific</timezone>
    <latitude>37.3362</latitude>
    <longitude>-121.889</longitude>
  </venue>
</rsp>

Output Fields

Note: The REST API does not return all possible fields for each item by default. Since some response fields are not used by most API users, these fields are suppressed from the response by default in order to reduce latency for the common calls. Additional fields can be enabled in the response using the fields parameters documented in the 'Optimizing API calls for performance' section.

Output Formats

REST responses can be returned in a number of different formats include XML, JSON and CSV. Read the documentation on output formats.

Possible Errors

This method may return one of the following errors.

Read the documentation on error formats.