Thrillcall API

This document describes the Thrillcall API v3, and usage for the provided Ruby API wrapper gem.

Ruby API Wrapper

Usage:

    #---------------------------------------------------------------#
    # First, require the gem:
    #---------------------------------------------------------------#
    require 'rubygems'
    require 'thrillcall-api'

    #---------------------------------------------------------------#
    # Instantiate with your Thrillcall API key:
    #---------------------------------------------------------------#
    MY_API_KEY = "1234567890abcdef"
    tc = ThrillcallAPI.new(MY_API_KEY)

    #---------------------------------------------------------------#
    # Access any endpoint directly from the instance
    #---------------------------------------------------------------#
    # This is like calling GET "/events"
    tc.events
    # => [ {"id" => ... }, {...}, ...]

    #---------------------------------------------------------------#
    # Provide IDs as arguments
    #---------------------------------------------------------------#
    # GET "/event/1"
    tc.event(1)
    # => {"id" => 1, ...}

    #---------------------------------------------------------------#
    # Provide parameters as arguments
    #---------------------------------------------------------------#
    # GET "/events?limit=5"
    events = tc.events(:limit => 5)
    # => [ {"id" => ... }, {...}, ...]
    events.length
    # => 5

    #---------------------------------------------------------------#
    # Chain methods together for nested routes
    #---------------------------------------------------------------#
    # GET "/search/venues/warfield?postalcode=94101&radius=20"
    venues = tc.search.venues("warfield", :postalcode => "94101", :radius => 20)
    # => [{"name" => "The Warfield", ...}]

Advanced Usage:

Provide additional instantiation options:


    #---------------------------------------------------------------#
    # The default SSL endpoint is "https://api.thrillcall.com/api/".
    # The default API version is 3.
    # By default, Faraday access logging is turned off.
    # Override if necessary:
    #---------------------------------------------------------------#
    tc = ThrillcallAPI.new(
      MY_API_KEY,
      :base_url => "https://api.thrillcall.com/custom/",
      :version  => 3,
      :logger   => true
    )

Internally, the wrapper returns a ThrillcallAPI::Result class for any call. Data for the request is fetched only when used. This allows you to build requests piecemeal before executing them.


    #---------------------------------------------------------------#
    # Build a partial request, add on to it later
    #---------------------------------------------------------------#
    request = tc.artist(22210) # Lady Gaga

    # GET "/artist/22210/events?limit=2"
    artist_events = request.events(:limit => 2)

    artist_events.length
    # => 2

This gem is a convenience wrapper around the excellent Faraday project. If more complicated use cases are necessary, consider using Faraday directly.


    require 'faraday'
    require 'json'

    MY_API_KEY  = "1234567890abcdef"
    BASE_URL    = "https://api.thrillcall.com/api/v3/"
    HEADERS     = { :accept => 'application/json' }

    connection  = Faraday.new( :url => BASE_URL, :headers => HEADERS ) do |builder|
      builder.adapter Faraday.default_adapter
      builder.response :logger
      builder.response :raise_error
    end

    request = connection.get do |req|
      req.url "artist/22210", { :api_key => MY_API_KEY }
    end

    artist = JSON.parse(request.body)

    artist["name"]
    # => "Lady Gaga"

HTTPS Endpoints

SSL/TLS Endpoints Required:

All API access must use the secure HTTPS endpoint : https://api.thrillcall.com:443 Access over an insecure HTTP (port 80) endpoint is now deprecated and will be disabled.

Parameters

These are valid parameters for any endpoint, however, they will only be used by the server where applicable.

api_key MUST BE SUPPLIED for every endpoint.

api_key string: (format: length == 16)

Your API key. Required for access to any endpoint.

limit integer

Default: 100

Sets the maximum number of results to return. Cannot be above 200.

page integer

Default: 0

Used in conjunction with limit.

Specifies the page number. If limit is 10, then page = 2 will return results #20 through #29
time_zone string (format: TZ Database string, eg "America/Los_Angeles")

Default: UTC For Metro Area endpoints, the default is instead the Metro Area's time zone and cannot be overridden.

min_date and max_date will be calculated based on this time zone.
min_date string (format: "YYYY-MM-DD")

Default: Today

Results before this date will not be returned.

max_date string (format: "YYYY-MM-DD")

Default: 1 year from Today

Results after this date will not be returned.

min_updated_at string (format: "YYYY-MM-DD")

Default: none

Results with updated_at columns before this date will not be returned.

max_updated_at string (format: "YYYY-MM-DD")

Default: none

Results with updated_at columns after this date will not be returned.

lat float

Default: none

If latitude (lat) and longitude (long) if both are specified, results will be within radius of this location.

For Person queries, this specifies the latitude of the person's location.
long float

Default: none

If latitude (lat) and longitude (long) if both are specified, results will be within radius of this location.

For Person queries, this specifies the longitude of the person's location.
postalcode string (format: length >= 5)

Default: none

Results will be within the radius of this postal code. If latitude (lat) and longitude (long) if both are specified, this will be ignored.
radius float

Default: 100.0

Used in conjunction with postalcode
use_partner_id boolean

Default: false

If set to true or 1, instead of using Thrillcall internal IDs, treat any IDs in a request as belonging to your partner definition.

Contact us to set up a list of definitions.

ticket_type string (format: "primary" or "resale")

Default: both

If specified, will only return tickets from Primary or Resale merchants.

must_have_tickets boolean

Default: false

If set to true or 1, will only return results that have tickets associated with them.

show_disabled_events boolean

Default: false

If set to true or 1, will not filter out events which have been disabled internally.

show_unconfirmed_events boolean

Default: false

If set to true or 1, will not filter out events with unconfirmed locations.

show_rumor_events boolean

Default: false

If set to true or 1, will not filter out events marked as rumored.

primary_genre_id integer

Default: none

If set, will filter Artist results to only those with the specified primary_genre_id
email string

The email address associated with a user, required for registration.

password string (format: 40 >= length >= 5)

The user's password. Must be supplied along with email unless using provider / uid / token auth.
provider string

The name of the authentication provider (e.g. "facebook"). Must be supplied along with uid and token unless using email/password auth.
uid string

The user's ID with provider. Must be supplied along with provider and token unless using email/password auth.
token string

The user's authentication token with provider. Must be supplied along with provider and uid unless using email/password auth.
first_name string (format: 50 >= length >= 2)

Required to register a user.

last_name string (format: 50 >= length >= 2)

Optional for registering a user.

gender string (format: length == 1)

Optional for registering a user.

location_name string (format: "City, ST or City, State", length > 0))

The name of the user's location when auto-registering. Either this or lat / long must be provided.
referral_code string

The referral code to be used during registration. Both the owner of the code as well as the new user will receive a referral credit point.

Artists

Fields:

created_at string ISO 8601 representation the time this object was created
genre_tags string Semicolon separated list of Genre names
id integer Thrillcall ID
name string Artist / Band Name
primary_genre_id integer The Thrillcall ID for this artist's primary Genre
upcoming_events_count integer Number of upcoming events associated with this object
updated_at string ISO 8601 representation of last time this object was updated
photos hash A hash of image urls of the primary photo available for this object in different styles
url string URL for this object on Thrillcall

GET /artists

Params:

limit
page
primary_genre_id

Returns: Array of Artists Hash

    // Example: GET /api/v3/artists?limit=14&api_key=1234567890abcdef

    [
      {
        "created_at": "2008-04-29T10:19:45Z",
        "genre_tags": "O",
        "id": 1,
        "name": "Hyler Jones Proteges",
        "primary_genre_id": 61,
        "upcoming_events_count": 0,
        "updated_at": "2010-03-26T16:49:20Z",
        "photos": {
          "thumbnail": "http://i.development.tc-core.com/artist/_default/default-thumbnail.jpg",
          "medium": "http://i.development.tc-core.com/artist/_default/default-medium.jpg",
          "large": "http://i.development.tc-core.com/artist/_default/default-large.jpg",
          "mobile": "http://i.development.tc-core.com/artist/_default/default-mobile.jpg"
        },
        "url": "http://thrillcall.com/artist/Hyler_Jones_Proteges"
      },
      {
        ...
      },
      ...
    ]

GET /artist/:id

:id integer Thrillcall or Partner ID

Params:

use_partner_id

Returns: Artist Hash

    // Example: GET /api/v3/artist/378465?api_key=1234567890abcdef

    {
      "created_at": "2011-05-19T20:27:47Z",
      "genre_tags": "Operatic pop",
      "id": 378465,
      "name": "Il Volo",
      "primary_genre_id": 61,
      "upcoming_events_count": 30,
      "updated_at": "2012-03-27T15:59:04Z",
      "photos": {
        "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
        "medium": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426",
        "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
        "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
      },
      "url": "http://thrillcall.com/artist/Il_Volo"
    }

GET /artist/:id/events

:id integer Thrillcall or Partner ID

Params:

limit
page
time_zone
min_date
max_date
min_updated_at
max_updated_at
lat
long
postalcode
radius
use_partner_id
ticket_type
must_have_tickets
show_disabled_events
show_unconfirmed_events
show_rumor_events

Returns: Array of Events Hash

    // Example: GET /api/v3/artist/378465/events?api_key=1234567890abcdef

    [
      {
        "created_at": "2012-03-02T08:01:03Z",
        "festival": false,
        "id": 1046915,
        "latitude": 47.6136,
        "longitude": -122.332,
        "name": "Il Volo @ Paramount Theatre - Seattle",
        "on_sale_date": null,
        "rumor": false,
        "start_date": "2012-10-02T19:30:00Z",
        "starts_at": "2012-10-03T02:30:00Z",
        "starts_at_time_trusted": true,
        "unconfirmed_location": 0,
        "updated_at": "2012-03-29T01:35:53Z",
        "venue_id": 61705,
        "photos": {
          "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
          "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
          "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
        },
        "url": "http://thrillcall.com/event/1046915",
        "starts_at_local": "2012-10-02T19:30:00-07:00",
        "time_zone": "America/Los_Angeles",
        "status": "confirmed"
      },
      {
        ...
      },
      ...
    ]

GET /search/artists/:term

:term string Arbitrary search string on the name field. (alphanumerics only, underscore matches underscore, use '+' for space)

Params:

limit
page

Returns: Array of Artists Hash

    // Example: GET /api/v3/search/artists/Il%20Volo?api_key=1234567890abcdef

    [
      {
        "created_at": "2011-05-19T20:27:47Z",
        "genre_tags": "Operatic pop",
        "id": 378465,
        "name": "Il Volo",
        "primary_genre_id": 61,
        "upcoming_events_count": 30,
        "updated_at": "2012-03-27T15:59:04Z",
        "photos": {
          "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
          "medium": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426",
          "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
          "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
        },
        "url": "http://thrillcall.com/artist/Il_Volo"
      },
      {
        ...
      },
      ...
    ]

Events

Fields:

created_at string ISO 8601 representation the time this object was created
festival boolean Is this event a festival?
id integer Thrillcall ID
latitude float Approximate latitude for the Event
longitude float Approximate longitude for the Event
name string Name of the Event
on_sale_date string ISO 8601 representation of the date when tickets go on sale
rumor boolean Are the details for this event based on a rumor?
status string Status of the event (confirmed, unconfirmed, cancelled, or disabled)
starts_at string ISO 8601 representation of the start of the Event in UTC time
starts_at_local string ISO 8601 representation of the start of the Event in the local timezone
starts_at_time_trusted boolean Do we trust that the time of day component of starts_at is valid?
time_zone string TZ Database string representing the time zone at the location of the event
unconfirmed_location integer If 1, the location of this event is unconfirmed
updated_at string ISO 8601 representation of last time this object was updated
venue_id integer Thrillcall Venue ID
photos hash A hash of image urls of the primary photo available for this object in different styles
url string URL for this object on Thrillcall

GET /events

Params:

limit
page
time_zone
min_date
max_date
min_updated_at
max_updated_at
lat
long
postalcode
radius
ticket_type
must_have_tickets
show_disabled_events
show_unconfirmed_events
show_rumor_events

Returns: Array of Events Hash

    // Example: GET /api/v3/events?must_have_tickets=true&postalcode=94108&radius=10&limit=3&api_key=1234567890abcdef

    [
      {
        "created_at": "2012-03-02T18:06:14Z",
        "festival": false,
        "id": 1047075,
        "latitude": 37.7915,
        "longitude": -122.413,
        "name": "Il Volo @ Masonic Center",
        "on_sale_date": null,
        "rumor": false,
        "start_date": "2012-09-29T19:30:04Z",
        "starts_at": "2012-09-30T02:30:04Z",
        "starts_at_time_trusted": true,
        "unconfirmed_location": 0,
        "updated_at": "2012-03-29T01:35:57Z",
        "venue_id": 63279,
        "photos": {
          "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
          "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
          "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
        },
        "url": "http://thrillcall.com/event/1047075",
        "starts_at_local": "2012-09-29T19:30:04-07:00",
        "time_zone": "America/Los_Angeles"
        "status": "confirmed"
      },
      {
        ...
      },
      ...
    ]

GET /event/:id

:id integer Thrillcall ID

Params:

None

Returns: Event Hash

    // Example: GET /api/v3/event/1045602/venue?api_key=1234567890abcdef

    {
      "address1": "1111 California Street",
      "address2": null,
      "city": "San Francisco",
      "country": "US",
      "created_at": "2009-08-25T19:25:27Z",
      "id": 63279,
      "latitude": 37.79153,
      "long_description": null,
      "longitude": -122.412757,
      "name": "Masonic Center",
      "phone_number": null,
      "state": "CA",
      "time_zone": "America/Los_Angeles",
      "upcoming_events_count": 4,
      "updated_at": "2012-04-04T02:08:50Z",
      "postalcode": "94108",
      "photos": {
        "thumbnail": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135",
        "medium": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135",
        "large": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135",
        "mobile": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"
      },
      "metro_area_id": 105,
      "url": "http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"
    }

GET /event/:id/artists

:id integer Thrillcall ID

Params:

limit
page

Returns: Array of Artists Hash

    // Example: GET /api/v3/event/1047075/artists?api_key=1234567890abcdef

    [
      {
        "created_at": "2011-05-19T20:27:47Z",
        "genre_tags": "Operatic pop",
        "id": 378465,
        "name": "Il Volo",
        "primary_genre_id": 61,
        "upcoming_events_count": 30,
        "updated_at": "2012-03-27T15:59:04Z",
        "photos": {
          "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
          "medium": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-medium.jpg?1324561426",
          "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
          "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
        },
        "url": "http://thrillcall.com/artist/Il_Volo"
      },
      {
        ...
      },
      ...
    ]

GET /event/:id/venue

:id integer Thrillcall ID

Params:

None

Returns: Venue Hash

    // Example: GET /api/v3/event/1045602/venue?api_key=1234567890abcdef

    {
      "address1": "1111 California Street",
      "address2": null,
      "city": "San Francisco",
      "country": "US",
      "created_at": "2009-08-25T19:25:27Z",
      "id": 63279,
      "latitude": 37.79153,
      "long_description": null,
      "longitude": -122.412757,
      "name": "Masonic Center",
      "phone_number": null,
      "state": "CA",
      "time_zone": "America/Los_Angeles",
      "upcoming_events_count": 4,
      "updated_at": "2012-04-04T02:08:50Z",
      "postalcode": "94108",
      "photos": {
        "thumbnail": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135",
        "medium": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135",
        "large": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135",
        "mobile": "http://i.development.tc-core.com/dan/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"
      },
      "metro_area_id": 105,
      "url": "http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"
    }

GET /event/:id/tickets

:id integer Thrillcall ID

Params:

limit
page
ticket_type

Returns: Array of Tickets Hash

    // Example: GET /api/v3/event/1047075/tickets?api_key=1234567890abcdef

    [
      {
        "created_at": "2012-03-02T18:06:14Z",
        "description": null,
        "event_id": 1047075,
        "id": 819883,
        "marketing_text": null,
        "max_ticket_price": 85,
        "min_ticket_price": 29,
        "name": "Onsale to General Public",
        "on_sale_end_date": null,
        "on_sale_start_date": null,
        "seat_info": null,
        "updated_at": "2012-03-02T18:06:14Z",
        "url": "http://ticketsus.at/thrillcall?CTY=39&DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&brand=[=BRAND=]"
      },
      {
        ...
      },
      ...
    ]

Genre

Fields:

created_at string ISO 8601 representation the time this object was created
description string Description of the Genre
id integer Thrillcall ID
name string Name of the Genre
updated_at string ISO 8601 representation of last time this object was updated

GET /genres

Params:

limit
page

Returns: Array of Genres Hash

    // Example: GET /api/v3/genres?limit=14&api_key=1234567890abcdef

    [
      {
        "created_at": "2008-07-09T19:17:45Z",
        "description": "Shawn Colvin, Loudon Wainwright III etc...",
        "id": 6,
        "name": "Folk",
        "updated_at": "2010-03-25T23:51:55Z"
      },
      {
        ...
      },
      ...
    ]

GET /genre/:id

:id integer Thrillcall ID

Params:

None

Returns: Genre Hash

    // Example: GET /api/v3/genre/27?api_key=1234567890abcdef

    {
      "created_at": "2008-07-09T19:17:45Z",
      "description": "U2, 30 Seconds To Mars etc...",
      "id": 27,
      "name": "Rock",
      "updated_at": "2010-03-25T23:52:21Z"
    }

GET /genre/:id/artists

:id integer Thrillcall ID

Params:

limit
page

Returns: Array of Artists Hash

    // Example: GET /api/v3/genre/61/artists?api_key=1234567890abcdef

    [
      {
        "created_at": "2008-04-29T10:19:45Z",
        "genre_tags": "O",
        "id": 1,
        "name": "Hyler Jones Proteges",
        "primary_genre_id": 61,
        "upcoming_events_count": 0,
        "updated_at": "2010-03-26T16:49:20Z",
        "photos": {
          "thumbnail": "http://i.development.tc-core.com/artist/_default/default-thumbnail.jpg",
          "medium": "http://i.development.tc-core.com/artist/_default/default-medium.jpg",
          "large": "http://i.development.tc-core.com/artist/_default/default-large.jpg",
          "mobile": "http://i.development.tc-core.com/artist/_default/default-mobile.jpg"
        },
        "url": "http://thrillcall.com/artist/Hyler_Jones_Proteges"
      },
      {
        ...
      },
      ...
    ]

Metro Area

Fields:

city string City of the Metro Area
country string Country of the Metro Area
created_at string ISO 8601 representation the time this object was created
id integer Thrillcall ID
latitude float Latitude of the Metro Area
longitude float Longitude of the Metro Area
radius integer Radius of the Metro Area from the Lat/Long center
state string State of the Metro Area
time_zone string Time zone of the Metro Area
updated_at string ISO 8601 representation of last time this object was updated
url string URL for this object on Thrillcall
offers_availability_status_code integer Offers status for the Metro Area ( no_offers = 0, available = 1, coming_soon = 2)

GET /metro_areas

Params:

limit
page

Returns: Array of Metro Areas Hash

    // Example: GET /api/v3/metro_areas?limit=14&api_key=1234567890abcdef

    [
      {
        "city": "Chicago",
        "country": "US",
        "created_at": "2011-06-24T03:23:57Z",
        "id": 104,
        "latitude": 41.8842,
        "longitude": -87.6324,
        "offers_availability_status_code": 1,
        "radius": 50,
        "state": "IL",
        "time_zone": "America/Chicago",
        "updated_at": "2011-12-27T00:44:37Z",
        "url": "http://thrillcall.com/live-music/chicago"
      },
      {
        ...
      },
      ...
    ]

GET /metro_area/:id

:id integer Thrillcall ID

Params:

None

Returns: Metro Area Hash

    // Example: GET /api/v3/metro_area/105?api_key=1234567890abcdef

    {
      "city": "San Francisco",
      "country": "US",
      "created_at": "2011-06-24T03:23:57Z",
      "id": 105,
      "latitude": 37.7771,
      "longitude": -122.42,
      "offers_availability_status_code": 1,
      "radius": 50,
      "state": "CA",
      "time_zone": "America/Los_Angeles",
      "updated_at": "2011-12-27T00:44:37Z",
      "url": "http://thrillcall.com/live-music/san-francisco"
    }

GET /metro_area/:id/events

:id integer Thrillcall ID

Params:

limit
page
min_date
max_date
min_updated_at
max_updated_at
radius
ticket_type
must_have_tickets
show_disabled_events
show_unconfirmed_events
show_rumor_events

Note: Time Zone is set as the time zone of the Metro Area and cannot be overridden.

Returns: Array of Metro Areas Hash

    // Example: GET /api/v3/metro_area/105/events?min_date=2011-04-05&max_date=2012-04-04&limit=3&api_key=1234567890abcdef

    [
      {
        "created_at": "2012-01-02T08:53:00Z",
        "festival": false,
        "id": 1011386,
        "latitude": 37.7771,
        "longitude": -122.42,
        "name": "Kontrol @ The End Up",
        "on_sale_date": null,
        "rumor": false,
        "start_date": "2012-01-07T00:00:04Z",
        "starts_at": "2012-01-07T08:00:04Z",
        "starts_at_time_trusted": false,
        "unconfirmed_location": 0,
        "updated_at": "2012-03-29T01:19:31Z",
        "venue_id": 47273,
        "photos": {
          "thumbnail": "http://i.development.tc-core.com/event/_default/default-thumbnail.jpg",
          "large": "http://i.development.tc-core.com/event/_default/default-large.jpg",
          "mobile": "http://i.development.tc-core.com/dan/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-mobile.jpg?1326489566"
        },
        "url": "http://thrillcall.com/event/1011386",
        "starts_at_local": "2012-01-07T00:00:04-08:00",
        "time_zone": "America/Los_Angeles"
        "status": "confirmed"
      },
      {
        ...
      },
      ...
    ]

Person

Note: Your API key requires the api_auth permission to access the endpoints associated with this object.

Fields:

created_at string ISO 8601 representation the time this object was created
first_name string First name of the Person
gender string Gender of the Person
id integer Thrillcall ID
last_name string Last name of the Person
login string Login (Email Address) of the Person
updated_at string ISO 8601 representation of last time this object was updated
referral_code string Referral code of the Person
referral_credits integer Number of Referral credits the Person has (including bonus points)
postalcode string Postalcode of the Person
photos hash A hash of image urls of the primary photo available for this object in different styles

GET /person/:id

Params:

None.

Returns: Person Hash

    // Example: GET /api/v3/person/49?api_key=1234567890abcdef

    {
      "address1": null,
      "address2": null,
      "city": "Santa Rosa",
      "country_code": "US",
      "created_at": "2011-10-17T18:54:31Z",
      "first_name": "John",
      "gender": "m",
      "id": 49,
      "last_name": "Doe",
      "login": "[email protected]",
      "state": "CA",
      "time_zone": "America/Los_Angeles",
      "timezone": "-7",
      "updated_at": "2012-03-28T16:07:16Z",
      "referral_code": null,
      "referral_credits": 0,
      "postalcode": "95407",
      "photos": {
        "small_thumb": "http://i.development.tc-core.com/dan/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
        "thumbnail": "http://i.development.tc-core.com/dan/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
        "medium": "http://i.development.tc-core.com/dan/person/164761/1324568419/19154-medium.jpg?1324568419"
      }
    }

Params:

email
password
provider
uid
token
first_name
last_name
location_name
lat
long
referral_code

Use either email / password or provider / uid / token.

May perform registration ("signup") automatically if using provider / uid / token when no match is found and name, location, and referral_code are also provided.

Returns: Person Hash

    // Example: POST /api/v3/person/signin?provider=facebook&uid=123123bogus&token=123123bogus&email=123123bogus%40bogus.com&first_name=Mister&last_name=Bogus&lat=38.5&long=-123.0&api_key=1234567890abcdef

    {
      "address1": null,
      "address2": null,
      "city": null,
      "country_code": null,
      "created_at": null,
      "first_name": "Mister",
      "gender": null,
      "last_name": "Bogus",
      "login": null,
      "state": null,
      "time_zone": null,
      "timezone": null,
      "updated_at": null,
      "referral_code": null,
      "referral_credits": 0,
      "postalcode": null,
      "photos": {
        "small_thumb": "http://i.development.tc-core.com/person/_default/default-small_thumb.jpg",
        "thumbnail": "http://i.development.tc-core.com/person/_default/default-thumbnail.jpg",
        "medium": "http://i.development.tc-core.com/person/_default/default-medium.jpg"
      }
    }

Params:

first_name
last_name
gender
email
password
postalcode
referral_code

Returns: Person Hash

    // Example: POST /api/v3/person/signup?first_name=Mister&email=bogus%40bogus.com&password=bogus&postalcode=94108&api_key=1234567890abcdef

    {
      "address1": null,
      "address2": null,
      "city": null,
      "country_code": null,
      "created_at": null,
      "first_name": "Mister",
      "gender": null,
      "last_name": null,
      "login": null,
      "state": null,
      "time_zone": null,
      "timezone": null,
      "updated_at": null,
      "referral_code": null,
      "referral_credits": 0,
      "postalcode": null,
      "photos": {
        "small_thumb": "http://i.development.tc-core.com/person/_default/default-small_thumb.jpg",
        "thumbnail": "http://i.development.tc-core.com/person/_default/default-thumbnail.jpg",
        "medium": "http://i.development.tc-core.com/person/_default/default-medium.jpg"
      }
    }

Venues

Fields:

address1 string First address field for the Venue
address2 string Second address field for the Venue
city string City the Venue is in
country string Country the Venue is in
created_at string ISO 8601 representation the time this object was created
id integer Thrillcall ID
latitude float Approximate Latitude for the Venue
long_description text Description of the Venue
longitude float Approximate Longitude for the Venue
name string Name of the Venue
metro_area_id integer Thrillcall ID of the Metro Area this Venue is in, if any
state string State the Venue is in
upcoming_events_count integer Number of upcoming events associated with this object
updated_at string ISO 8601 representation of last time this object was updated
postalcode string Postal code for the Venue
phone_number string Phone number for the Venue (including country code)
photos hash A hash of image urls of the primary photo available for this object in different styles
url string URL for this object on Thrillcall

GET /venues

Params:

limit
page
lat
long
postalcode
radius

Returns: Array of Venues Hash

    // Example: GET /api/v3/venues?limit=14&api_key=1234567890abcdef

    [
      {
        "address1": null,
        "address2": null,
        "city": "Guadalajara",
        "country": "MX",
        "created_at": "2008-05-09T09:29:23Z",
        "id": 1,
        "latitude": 20.666222,
        "long_description": null,
        "longitude": -103.352089,
        "name": "Fbolko",
        "phone_number": null,
        "state": "MX",
        "time_zone": "America/Mexico_City",
        "upcoming_events_count": 0,
        "updated_at": "2012-03-29T00:04:23Z",
        "postalcode": null,
        "photos": {
          "thumbnail": "http://i.development.tc-core.com/venue/_default/default-thumbnail.jpg",
          "medium": "http://i.development.tc-core.com/venue/_default/default-medium.jpg",
          "large": "http://i.development.tc-core.com/venue/_default/default-large.jpg",
          "mobile": "http://i.development.tc-core.com/venue/_default/default-mobile.jpg"
        },
        "metro_area_id": null,
        "url": "http://thrillcall.com/venue/Fbolko_in_Guadalajara_MX"
      },
      {
        ...
      },
      ...
    ]

GET /venue/:id

:id integer Thrillcall or Partner ID

Params:

use_partner_id

Returns: Venue Hash

    // Example: GET /api/v3/venue/51886?api_key=1234567890abcdef

    {
      "address1": "201 Van Ness Avenue",
      "address2": null,
      "city": "San Francisco",
      "country": "US",
      "created_at": "2008-04-28T17:59:32Z",
      "id": 51886,
      "latitude": 37.777402,
      "long_description": null,
      "longitude": -122.419815,
      "name": "Davies Symphony Hall",
      "phone_number": "(415) 864-6000",
      "state": "CA",
      "time_zone": "America/Los_Angeles",
      "upcoming_events_count": 48,
      "updated_at": "2012-03-28T03:13:27Z",
      "postalcode": "94102",
      "photos": {
        "thumbnail": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-thumbnail.jpg?1326417154",
        "medium": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-medium.jpg?1326417154",
        "large": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-large.jpg?1326417154",
        "mobile": "http://i.development.tc-core.com/dan/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-mobile.jpg?1326417154"
      },
      "metro_area_id": 105,
      "url": "http://thrillcall.com/venue/Davies_Symphony_Hall_in_San_Francisco_CA"
    }

GET /venue/:id/events

:id integer Thrillcall or Partner ID

Params:

limit
page
time_zone
min_date
max_date
min_updated_at
max_updated_at
use_partner_id
ticket_type
must_have_tickets
show_disabled_events
show_unconfirmed_events
show_rumor_events

Returns: Array of Events Hash

    // Example: GET /api/v3/venue/63279/events?api_key=1234567890abcdef

    [
      {
        "created_at": "2012-03-02T18:06:14Z",
        "festival": false,
        "id": 1047075,
        "latitude": 37.7915,
        "longitude": -122.413,
        "name": "Il Volo @ Masonic Center",
        "on_sale_date": null,
        "rumor": false,
        "start_date": "2012-09-29T19:30:04Z",
        "starts_at": "2012-09-30T02:30:04Z",
        "starts_at_time_trusted": true,
        "unconfirmed_location": 0,
        "updated_at": "2012-03-29T01:35:57Z",
        "venue_id": 63279,
        "photos": {
          "thumbnail": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-thumbnail.jpg?1324561426",
          "large": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-large.jpg?1324561426",
          "mobile": "http://i.development.tc-core.com/dan/artist/378465/10658/1324561426/il-volo-mobile.jpg?1324561426"
        },
        "url": "http://thrillcall.com/event/1047075",
        "starts_at_local": "2012-09-29T19:30:04-07:00",
        "time_zone": "America/Los_Angeles"
        "status": "confirmed"
      },
      {
        ...
      },
      ...
    ]

GET /search/venues/:term

:term string Arbitrary search string on the name field. (alphanumerics only, underscore matches underscore, use '+' for space)

Params:

limit
page
lat
long
postalcode
radius

Returns: Array of Venues Hash

    // Example: GET /api/v3/search/venues/Masonic%20Center?api_key=1234567890abcdef

    [
      {
        "address1": "525 W Riverview Ave",
        "address2": null,
        "city": "Dayton",
        "country": "US",
        "created_at": "2008-06-12T14:12:53Z",
        "id": 33642,
        "latitude": 39.765526,
        "long_description": null,
        "longitude": -84.203133,
        "name": "Dayton Masonic Center",
        "phone_number": null,
        "state": "OH",
        "time_zone": "America/New_York",
        "upcoming_events_count": 0,
        "updated_at": "2012-03-28T03:11:49Z",
        "postalcode": "45405",
        "photos": {
          "thumbnail": "http://i.development.tc-core.com/venue/_default/default-thumbnail.jpg",
          "medium": "http://i.development.tc-core.com/venue/_default/default-medium.jpg",
          "large": "http://i.development.tc-core.com/venue/_default/default-large.jpg",
          "mobile": "http://i.development.tc-core.com/venue/_default/default-mobile.jpg"
        },
        "metro_area_id": 134,
        "url": "http://thrillcall.com/venue/Dayton_Masonic_Center_in_Dayton_OH"
      },
      {
        ...
      },
      ...
    ]

Tickets

Fields:

created_at string ISO 8601 representation the time this object was created
description string Long form description of the ticket
event_id integer Thrillcall Event ID
id integer Thrillcall ID
marketing_text string Long form description of the ticket
max_ticket_price float Maximum price for this ticket
min_ticket_price float Minimum price for this ticket
name string Name of this ticket
on_sale_end_date string YYYY-MM-DD date when the ticket goes off sale
on_sale_start_date string YYYY-MM-DD date when the ticket goes on sale
seat_info string Additional info about the seat
updated_at string ISO 8601 representation of last time this object was updated
url string URL for this object on Thrillcall

GET /tickets

Params:

limit
page
time_zone
min_date
max_date
min_updated_at
max_updated_at
lat
long
postalcode
radius
ticket_type
show_disabled_events
show_unconfirmed_events
show_rumor_events

Returns: Array of Tickets Hash

    // Example: GET /api/v3/tickets?limit=14&api_key=1234567890abcdef

    [
      {
        "created_at": "2008-12-06T00:19:59Z",
        "description": null,
        "event_id": 455646,
        "id": 1,
        "marketing_text": null,
        "max_ticket_price": null,
        "min_ticket_price": null,
        "name": "General Onsale",
        "on_sale_end_date": null,
        "on_sale_start_date": null,
        "seat_info": null,
        "updated_at": "2009-09-22T22:58:37Z",
        "url": "http://www.livenation.com/edp/eventId/335800/?c=api-000157"
      },
      {
        ...
      },
      ...
    ]

GET /ticket/:id

:id integer Thrillcall ID

Params:

None

Returns: Ticket Hash

    // Example: GET /api/v3/ticket/819883?api_key=1234567890abcdef

    {
      "created_at": "2012-03-02T18:06:14Z",
      "description": null,
      "event_id": 1047075,
      "id": 819883,
      "marketing_text": null,
      "max_ticket_price": 85,
      "min_ticket_price": 29,
      "name": "Onsale to General Public",
      "on_sale_end_date": null,
      "on_sale_start_date": null,
      "seat_info": null,
      "updated_at": "2012-03-02T18:06:14Z",
      "url": "http://ticketsus.at/thrillcall?CTY=39&DURL=http://www.ticketmaster.com/event/1C00486178A1251A?camefrom=CFC_BUYAT&brand=[=BRAND=]"
    }

Thrillcall API

Ruby API Wrapper

Usage:

Advanced Usage:

HTTPS Endpoints

SSL/TLS Endpoints Required:

Parameters

Artists

GET /artists

GET /artist/:id

GET /artist/:id/events

GET /search/artists/:term

Events

GET /events

GET /event/:id

GET /event/:id/artists

GET /event/:id/venue

GET /event/:id/tickets

Genre

GET /genres

GET /genre/:id

GET /genre/:id/artists

Metro Area

GET /metro_areas

GET /metro_area/:id

GET /metro_area/:id/events

Person

GET /person/:id

POST /person/signin

POST /person/signup

Venues

GET /venues

GET /venue/:id

GET /venue/:id/events

GET /search/venues/:term

Tickets

GET /tickets

GET /ticket/:id