API Method /performers/get

Given a performer ID, returns the performer data associated with that performer.

Arguments

authentication
This method controls access via authentication.
id string
The ID of the requested performer.
show_events boolean
If true, include the events list. (see below)
image_sizes string
A comma separted list of image_sizes desired. See Faq for list of possible image sizes. (optional)

Example Request

Here's an example request URL:

http://api.eventful.com/rest/performers/get?...&id=P0-001-000000045-2

Output Parameters

Output from this function is an XML block ("performer") with the following constructs.
id string
The unique ID for this performer.
url string
The page URL for this performer on eventful.com.
name string
The name of this performer.
is_human boolean
True if this performer is human (a singer, a band, a company) rather than abstract (a film, an idea, a musical composition)
short_bio string
A short biography of this performer.
long_bio string
A detailed biography of this performer.
demand_count integer
The number of demands for this performer.
demand_member_count integer
The number of people who joined demands for this performer.
event_count integer
The number of events involving this performer.
created datetime
The date & time the performer was initially created. (e.g. '2006-03-17 16:55:00')
creator string
The username of the performer's creator.
withdrawn boolean
True if this performer has been marked as withdrawn.
withdrawn_note string
If this performer has been marked as withdrawn, a short reason why.
links array
An array of link entries
comments array
An array of comment entries
images array
An array of image entries
tags array
An array of tag entries
demands array
An array of demand entries
events array
An array of event entries. This list is only included if the show_events parameter is true.

Example XML Response

<?xml version="1.0" encoding="UTF-8"?>
<performer id="P0-001-000000567-9">
  <url>http://eventful.com/performers/wil-wheaton/author-blogger-actor-/
  P0-001-000000567-9?utm_source=apis&utm_medium=apim&utm_campaign=apic
  </url>
  <name>Wil Wheaton</name>
  <is_human>0</is_human>
  <short_bio>writer, blogger, PokerStar, actor</short_bio>
  <long_bio>I'm just this guy, you know? Oh. You want more. Okay:
  I'm an actor, writer, poker player, stepfather, and (relatively)
  long-time blogger. Everything you could ever want to know about me can
  be found on my blog.

[from Wil's Technorati profile]</long_bio>
  <created>2006-03-09 10:41:35.438997</created>
  <creator>wilwheaton</creator>
  <demand_count>76</demand_count>
  <demand_member_count>635</demand_member_count>
  <event_count>0</event_count>
  <withdrawn>0</withdrawn>
  <withdrawn_note/>
  <user_id>4899</user_id>
  <links>
    <link id="40">
      <url>http://www.technorati.com/profile/wilw</url>
      <type>Info</type>
      <description>Technorati Profile for Wil Wheaton</description>
      <username>chris_radcliff</username>
      <user_reputation>1</user_reputation>
      <time>2006-03-09 10:42:13.623614</time>
    </link>
    ...
  </links>
  <comments>
    <comment id="4">
      <text>Wil Wheaton is just...hawesome!!  </text>
      <username>RipRyder</username>
      <user_reputation>1</user_reputation>
      <time>2006-03-13 23:40:20.971301</time>
    </comment>
    ...
  </comments>
  <trackbacks/>
  <images>
    <image>
      <id>I0-001-000070464-6</id>
      <caption/>
      <creator>chris_radcliff</creator>
      <url>http://images.evdb.com/images/small/I0-001/000/070/464-6.jpeg</url>
      <width>48</width>
      <height>58</height>
      <small>
        <url>http://images.evdb.com/images/small/I0-001/000/070/464-6.jpeg</url>
        <width>48</width>
        <height>58</height>
      </small>
      <large>
        <url>http://images.evdb.com/images/large/I0-001/000/070/464-6.jpeg</url>
        <width>480</width>
        <height>576</height>
      </large>
      <original>
        <url>http://images.evdb.com/images/original/I0-001/000/070/464-6.jpeg</url>
        <width>667</width>
        <height>800</height>
      </original>
      <medium>
        <url>http://images.evdb.com/images/medium/I0-001/000/070/464-6.jpeg</url>
        <width>128</width>
        <height>154</height>
      </medium>
      <block>
        <url>http://images.evdb.com/images/block/I0-001/000/070/464-6.jpg</url>
        <width>128</width>
        <height>128</height>
      </block>
      <thumb>
        <url>http://images.evdb.com/images/thumb/I0-001/000/070/464-6.jpg</url>
        <width>48</width>
        <height>48</height>
      </thumb>
    </image>
  </images>
  <tags>
    <tag id="actor">
      <title>actor</title>
      <owner>wilwheaton</owner>
    </tag>
    ...
  </tags>
  <demands>
    <demand>
      <id>D0-001-000000138-1</id>
      <location>San Francisco metro area</location>
      <description>You've been here before! You loved it! We loved you!
      Anne loves us!  We love her!  It's meant to be!</description>
      <member_count>61</member_count>
    </demand>
    ...
  </demands>
  <events/>
</performer>

Error Codes

This method may return these errors in an error document:

Authentication error
The specified user was not found or provided invalid credentials.
Missing parameter
A required parameter was not provided.
Not found
There is no performer with that identifier.