Paging & Number of results

For all of the following APIs, you can add parameters

page={Positive integer}

(default is 1, The starting page for the search result.)

pageSize={Positive integer}

(default is 10, The desired number of each call)

For example, to get the page 2, with 15 items.

Search events nearby

Optional parameters:

criteria=search keyword

sorttype=Popularity, Date

sortdir=Descending, Ascending

unit=km, mi

date=

  • All e.g. date=All
  • Today e.g. date=Today
  • This Week e.g. date=This+Week
  • Next Week e.g. date=Next+Week
  • daterange , additional parameters: startdate and enddate (format YYYYMMDDHH), e.g. date=daterange & startdate=2013081301 & enddate=2013083023
  • {month} e.g. date=September

for example, search for hockey in New York:

<poyntevent version="1.6">
      <searchEventsResponse>
      <date>This Week</date>
      <more>true</more>
      <totalPages>2</totalPages>
      <event>
      <num>1</num>
      <id>
           {"sectionId":"10","internalDatabaseId":null,"partnerClickIds":[{"partnerProvidedListingId":"E0-001-055621621-3","partnerId":"20","extraDataFields":null,"clickThruTypeIdsToProcess":null}]}
      </id>
      <name>Pro Ambitions Hockey, Inc - Stamford</name>
      <startTime>2013-05-15</startTime>
      <stopTime>2013-08-15</stopTime>
      <isClickThru>true</isClickThru>
      <website>
      <url>

http://eventful.com/stamford/events/pro-ambitions-hockey-inc-stamford-/E0-001-055621621-3?utm_source=apis&utm_medium=apim&utm_campaign=apic

      </url>
      <tag>More From Eventful</tag>
      </website>
      <venue>
           <id>
                 {"sectionId":"10","internalDatabaseId":null,"partnerClickIds":[{"partnerProvidedListingId":"V0-001-000527124-0","partnerId":"20","extraDataFields":null,"clickThruTypeIdsToProcess":null}]}
           </id>
           <name>Postal code 06904, United States</name>
           <city>Stamford</city>
           <province>CT</province>
           <country>US</country>
           <countryCode>US</countryCode>
           <postal>06904</postal>
           <latitude>41.0535</latitude>
           <longitude>-73.5394</longitude>
           <distance>48.93</distance>
           <isClickThru>true</isClickThru>
          <direction azimuth="56.68554193250287">NE</direction>
      </venue>
   <venues>
</event>
...
</searchEventsResponse>
</poyntevent>

Get single event by Id

Get the event by event Id:

For example, event_id is

{“sectionId”:“10”,”internalDatabaseId”:null,”partnerClickIds”:[{“partnerProvidedListingId”:“E0-001-055621621-3”,”partnerId”:“20”,”extraDataFields”:null,”clickThruTypeIdsToProcess”:null}]}

Get event categories

To retrieve a list of event categories

<categories>
 <category Hjid="4">
     <id>music</id>
     <name>Concerts & Tour Dates</name>
 </category>
 <category Hjid="5">
     <id>conference</id>
     <name>Conferences & Tradeshows</name>
 </category>
 <category Hjid="6">
     <id>comedy</id>
     <name>Comedy</name>
 </category>
 <category Hjid="7">
     <id>learning_education</id>
     <name>Education</name>
 </category>
 <category Hjid="8">
     <id>family_fun_kids</id>
     <name>Kids & Family</name>
 </category>
 <category Hjid="9">
     <id>festivals_parades</id>
     <name>Festivals</name>
 </category>
 <category Hjid="10">
     <id>movies_film</id>
     <name>Film</name>
 </category>
 <category Hjid="11">
     <id>food</id>
     <name>Food & Wine</name>
 </category>
 <category Hjid="12">
     <id>fundraisers</id>
     <name>Fundraising & Charity</name>
 </category>
 <category Hjid="13">
     <id>art</id>
     <name>Art Galleries & Exhibits</name>
 </category>
</categories>

Search events by category

categoryid=search category

for example, search for category ‘family_fun_kids’ in New York:

Search venues nearby

criteria=search keyword (optional parameter)

for example, search for music in New York:

<poyntvenue version="1.6">
 <searchVenuesResponse>
    <more>true</more>
    <totalPages>4702</totalPages>
    <venue>
    <id>
         {"sectionId":"10","internalDatabaseId":null,"partnerClickIds":[{"partnerProvidedListingId":"V0-001-001427529-3","partnerId":"20","extraDataFields":null,"clickThruTypeIdsToProcess":null}]}
    </id>
    <num>1</num>
    <name>Air Canada Centre</name>
    <type>Arena</type>
    <street>40 Bay Street</street>
    <city>Toronto</city>
    <province>ON</province>
    <country>CA</country>
    <countryCode>CA</countryCode>
    <latitude>43.6437852</latitude>
    <longitude>-79.3784416</longitude>
    <distance>19.36</distance>
    <eventCount>193</eventCount>
   <images>
 <image>
     <thumbnail>
        <url>http://s4.evcdn.com/images/thumb/I0-001/003/991/531-2.jpeg_/air-canada-centre-31.jpeg</url>
        <width>48</width>
        <height>48</height>
     </thumbnail>
     <medium>
        <url>http://s4.evcdn.com/images/medium/I0-001/003/991/531-2.jpeg_/air-canada-centre-31.jpeg</url>
        <width>128</width>
        <height>128</height>
     </medium>
   </image>
 </images>
   <isClickThru>true</isClickThru>
  <direction azimuth="142.5799437096697">SE</direction>
 </venue>
 
Get single venue by Id

Get the venue by venue Id:

For example, venue_id is {“internalDatabaseId”:null,”partnerClickIds”:[{“clickThruTypeIdsToProcess”:null,”partnerId”:“20”,”partnerProvidedListingId”:“V0-001-004766342-3”,”extraDataFields”:null}],”sectionId”:“10”}

Search performers nearby

criteria=search keyword (optional parameter)

for example, search for ‘justin’ in Los Angeles:

<poyntperformer version="1.6">
   <searchPerformersResponse>
   <more>true</more>
   <totalPages>24</totalPages>
   <performer>
    <num>1</num>
     <id>{"internalDatabaseId":null,"partnerClickIds":[{"clickThruTypeIdsToProcess":null,"partnerId":"20","partnerProvidedListingId":"P0-001-000165263-2","extraDataFields":null}],"sectionId":"10"}
     </id>
     <name>Justin Bieber</name>
     <shortBio>Pop</shortBio>
     <eventCount>37</eventCount>
     <isClickThru>true</isClickThru>
     <website>
       <url>
             http://eventful.com/performers/justin-bieber-/P0-001-000165263-2?utm_source=apis&utm_medium=apim&utm_campaign=apic
       </url>
       <tag>More From Eventful</tag>
     </website>
     <images>
       <image>
          <thumbnail>
           <url>http://s3.evcdn.com/images/thumb/I0-001/013/609/166-3.png_/justin-bieber-66.png</url>
           <width>48</width>
           <height>48</height>
         </thumbnail>
         <medium>
           <url>http://s3.evcdn.com/images/medium/I0-001/013/609/166-3.png_/justin-bieber-66.png</url>
           <width>128</width>
           <height>128</height>
         </medium>
      </image>
   </images>
 </performer>

Get single performer by Id

Get the performer by performer Id:

For example, performer_id is

{“internalDatabaseId”:null,”partnerClickIds”:[{“clickThruTypeIdsToProcess”:null,”partnerId”:“20”,”partnerProvidedListingId”:“P0-001-000165263-2”,”extraDataFields”:null}],”sectionId”:“10”}