Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Thrillcall API Client Ruby Gem
Ruby
Failed to load latest commit information.
autotest
docs
lib
script
spec
.autotest
.gitignore
.rspec
.ruby-gemset
.ruby-version
Gemfile
Gemfile.lock
README.md
Rakefile
thrillcall-api.gemspec

README.md

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", ...}]

    #---------------------------------------------------------------#
    # POST and PUT are explicit methods
    #---------------------------------------------------------------#
    artist = tc.artist.post(:name => "Bleeding Chest Wounds")
    # => {"id" => 3, "name" => "Bleeding Chest Wounds", ...}

    artist = tc.artist(3).put(:name => "Grizzle and The Plenty")
    # => {"id" => 3, "name" => "Grizzle and The Plenty", ...}

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.
    # If a connection attempt fails, we will retry 5 times with a
    # timeout of 10 seconds.  We retry a boilerplate list of
    # exceptions, such as Faraday::Error::ClientError.
    # Override these if necessary:
    #---------------------------------------------------------------#
    tc = ThrillcallAPI.new(
      MY_API_KEY,
      :base_url         => "https://api.thrillcall.com/custom/",
      :version          => 3,
      :logger           => true,
      :retry_exceptions => [Timeout::Error],
      :retry_tries      => 5,
      :timeout          => 10
    )

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

Contents

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.

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
  • popularity float A number from 0.0 to 1.0 indicating relative popularity of the Artist, 1.0 being most popular
  • 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
  • facebook_url string URL for this object on Facebook
  • myspace_url string Myspace URL for this object
  • official_url string Official external URL for this object
  • wikipedia_url string Wikipedia URL for this object
  • youtube_url string YouTube URL for this object

GET /artists

Params:

Returns: Array of Artists Hash

    // Example: GET /api/v3/artists?mappings=livenation&page=60801&limit=5&api_key=1234567890abcdef

    [
      {
        "id": 381,
        "name": "Reverend Horton Heat",
        "official_url": "http://www.reverendhortonheat.com/",
        "wikipedia_url": "http://en.wikipedia.com/wiki/Reverend_Horton_Heat",
        "myspace_url": "http://www.myspace.com/reverendhortonheat",
        "created_at": "2008-04-21T16:53:40Z",
        "updated_at": "2014-04-09T03:30:02Z",
        "genre_tags": "psychobilly;Rock;rockabilly",
        "primary_genre_id": 27,
        "upcoming_events_count": 43,
        "facebook_url": "http://www.facebook.com/reverendhortonheat",
        "featured_at": null,
        "youtube_url": null,
        "foreign_mappings": [
          {
            "id": 10809,
            "partner_id": "livenation",
            "obj_type": "artist",
            "partner_display_name": "Reverend Horton Heat",
            "partner_obj_id": "700116",
            "created_at": "2009-08-13T04:22:26Z",
            "updated_at": "2012-08-07T02:54:25Z"
          }
        ],
        "popularity": 0.447929,
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/381/1451/1324556983/reverend-horton-heat-thumbnail.jpg?1324556983",
          "medium": "http://i1.tc-core.com/artist/381/1451/1324556983/reverend-horton-heat-medium.jpg?1324556983",
          "large": "http://i1.tc-core.com/artist/381/1451/1324556983/reverend-horton-heat-large.jpg?1324556983",
          "mobile": "http://i1.tc-core.com/artist/381/1451/1324556983/reverend-horton-heat-mobile.jpg?1324556983"
        },
        "url": "http://thrillcall.com/artist/Reverend-Horton-Heat"
      },
      {
        ...
      },
      ...
    ]

POST /artist

Params:

Creates a new Artist record with the provided parameters.

Returns: Artist Hash

    // Example: POST /api/v3/artist?name=Bleeding%20Chest%20Wounds&wikipedia_url=http%3A%2F%2Ftest.com&api_key=1234567890abcdef

    {
      "created_at": null,
      "facebook_url": null,
      "genre_tags": null,
      "myspace_url": null,
      "name": "Bleeding Chest Wounds",
      "official_url": null,
      "popularity": 0.0,
      "permalink": null,
      "primary_genre_id": null,
      "upcoming_events_count": 0,
      "updated_at": null,
      "wikipedia_url": "http://test.com",
      "youtube_url": null,
      "photos": {
        "thumbnail": "http://i1.tc-core.com/artist/_default/default-thumbnail.jpg",
        "medium": "http://i1.tc-core.com/artist/_default/default-medium.jpg",
        "large": "http://i1.tc-core.com/artist/_default/default-large.jpg",
        "mobile": "http://i1.tc-core.com/artist/_default/default-mobile.jpg"
      }
    }

GET /artist/:id

:id integer Thrillcall or Mapping

Params:

Returns: Artist Hash

    // Example: GET /api/v3/artist/12?mappings=livenation&api_key=1234567890abcdef

    {
      "id": 12,
      "name": "Southside Johnny And The Asbury Jukes",
      "official_url": "http://www.southsidejohnny.com/",
      "wikipedia_url": "http://en.wikipedia.org/wiki/Southside_Johnny_%26_The_Asbury_Jukes",
      "myspace_url": "http://www.myspace.com/southsidejohnnyandtheasburyjukes",
      "created_at": "2008-05-08T18:33:35Z",
      "updated_at": "2014-04-09T03:28:35Z",
      "genre_tags": "classic rock",
      "primary_genre_id": 27,
      "upcoming_events_count": 10,
      "facebook_url": null,
      "featured_at": null,
      "youtube_url": null,
      "foreign_mappings": [
        {
          "id": 11504,
          "partner_id": "livenation",
          "obj_type": "artist",
          "partner_display_name": "Southside Johnny",
          "partner_obj_id": "28610",
          "created_at": "2009-08-13T04:41:27Z",
          "updated_at": "2012-08-07T02:54:38Z"
        },
        {
          "id": 11505,
          "partner_id": "livenation",
          "obj_type": "artist",
          "partner_display_name": "Southside Johnny & The Asbury Jukes",
          "partner_obj_id": "6208",
          "created_at": "2009-08-13T04:41:27Z",
          "updated_at": "2012-08-07T02:54:38Z"
        }
      ],
      "popularity": 0.42081,
      "photos": {
        "thumbnail": "http://i1.tc-core.com/artist/12/2778/1324557379/southside-johnny-and-the-asbury-jukes-thumbnail.jpg?1324557379",
        "medium": "http://i1.tc-core.com/artist/12/2778/1324557379/southside-johnny-and-the-asbury-jukes-medium.jpg?1324557379",
        "large": "http://i1.tc-core.com/artist/12/2778/1324557379/southside-johnny-and-the-asbury-jukes-large.jpg?1324557379",
        "mobile": "http://i1.tc-core.com/artist/12/2778/1324557379/southside-johnny-and-the-asbury-jukes-mobile.jpg?1324557379"
      },
      "url": "http://thrillcall.com/artist/Southside-Johnny-And-The-Asbury-Jukes"
    }

PUT /artist/:id

:id integer Thrillcall or Mapping

Params:

Updates the provided fields on Artist :id.

Returns: Artist Hash

    // Example: PUT /api/v3/artist/12569?wikipedia_url=http%3A%2F%2Ftest.com&api_key=1234567890abcdef

    {
      "created_at": "2008-04-21T16:53:17Z",
      "facebook_url": null,
      "genre_tags": "acoustic;Country;Rock;rockabilly",
      "id": 12569,
      "myspace_url": "http://www.myspace.com/chrisisaak",
      "name": "Chris Isaak",
      "official_url": "http://www.chrisisaak.com/",
      "primary_genre_id": 27,
      "popularity": 0.0,
      "upcoming_events_count": 58,
      "updated_at": "2012-07-02T09:55:40Z",
      "wikipedia_url": "http://test.com",
      "youtube_url": null,
      "photos": {
        "thumbnail": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-thumbnail.jpg?1324556547",
        "medium": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-medium.jpg?1324556547",
        "large": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-large.jpg?1324556547",
        "mobile": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-mobile.jpg?1324556547"
      },
      "url": "http://thrillcall.com/artist/Chris_Isaak"
    }

GET /artist/:id/events

:id integer Thrillcall or Mapping

Params:

Returns: Array of Events Hash

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

    [
      {
        "id": 1462860,
        "name": "Il Volo @ Freedom Hill Amphitheater",
        "venue_id": 49270,
        "created_at": "2014-04-01T22:38:41Z",
        "updated_at": "2014-04-01T22:38:41Z",
        "festival": false,
        "rumor": false,
        "unconfirmed_location": 0,
        "latitude": null,
        "longitude": null,
        "starts_at": "2014-06-19T23:30:00Z",
        "starts_at_time_trusted": true,
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/378465/22623/1360966614/il-volo-thumbnail.jpg?1360966614",
          "large": "http://i1.tc-core.com/artist/378465/22623/1360966614/il-volo-large.jpg?1360966614",
          "mobile": "http://i1.tc-core.com/artist/378465/22623/1360966614/il-volo-mobile.jpg?1360966614"
        },
        "url": "http://thrillcall.com/event/1462860",
        "starts_at_local": "2014-06-19T19:30:00-04:00",
        "time_zone": "America/Detroit",
        "event_status": "confirmed",
        "name_modified": false,
        "featured_event": false,
        "venue": {
          "id": 49270,
          "name": "Freedom Hill Amphitheater",
          "address1": "Formerly known as Jerome Duncan Ford Theatre",
          "address2": null,
          "city": "Sterling Heights",
          "state": "MI",
          "official_url": "http://freedomhill.net/",
          "created_at": "2008-06-07T03:55:39Z",
          "updated_at": "2013-10-06T09:41:10Z",
          "latitude": 42.5933,
          "longitude": -83.013367,
          "country_code": "US",
          "myspace_url": null,
          "upcoming_events_count": 0,
          "facebook_url": "http://www.facebook.com/freedomhillMI",
          "long_description": null,
          "phone_number": null,
          "time_zone": "America/Detroit",
          "hide_resale_tickets": false,
          "wikipedia_url": null,
          "photos": {
            "thumbnail": "http://i1.tc-core.com/venue/_default/default-thumbnail.jpg",
            "medium": "http://i1.tc-core.com/venue/_default/default-medium.jpg",
            "large": "http://i1.tc-core.com/venue/_default/default-large.jpg",
            "mobile": "http://i1.tc-core.com/venue/_default/default-mobile.jpg"
          },
          "postalcode": "48312",
          "metro_area_id": 136,
          "ticket_providers": [
            {
              "id": 1997,
              "merchant_id": 2,
              "name": "Ticketmaster",
              "url": "http://ticketsus.at/thrillcall/65757.html",
              "primary": true,
              "tier": 0,
              "display_index": 0,
              "image": "http://i1.tc-core.com/merchant/2/1324584352/2-full.jpg?1324584352"
            },
            {
              "id": 8732,
              "merchant_id": 36,
              "name": "AXS",
              "url": "http://www.axs.com/venues/2327/freedom-hill-amphitheatre-sterling-heights-tickets",
              "primary": true,
              "tier": 0,
              "display_index": 33,
              "image": "http://i1.tc-core.com/merchant/36/1365101348/162-full.jpg?1365101348"
            }
          ],
          "url": "http://thrillcall.com/venue/Freedom_Hill_Amphitheater_in_Sterling_Heights_MI"
        },
        "artists": [
          {
            "id": 378465,
            "name": "Il Volo",
            "headliner": false,
            "photos": {
              "thumbnail": "http://i1.tc-core.com/artist/378465/22623/1360966614/il-volo-thumbnail.jpg?1360966614",
              "medium": "http://i1.tc-core.com/artist/378465/22623/1360966614/il-volo-medium.jpg?1360966614",
              "large": "http://i1.tc-core.com/artist/378465/22623/1360966614/il-volo-large.jpg?1360966614",
              "mobile": "http://i1.tc-core.com/artist/378465/22623/1360966614/il-volo-mobile.jpg?1360966614"
            }
          }
        ],
        "offer_details": null
      },
      {
        ...
      },
      ...
    ]

GET /search/artists/:term

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

Params:

Returns: Array of Artists Hash

    // Example: GET /api/v3/search/artists/Chris%20Isaak?api_key=1234567890abcdef

    [
      {
        "created_at": "2008-04-21T16:53:17Z",
        "facebook_url": null,
        "genre_tags": "acoustic;Country;Rock;rockabilly",
        "id": 12569,
        "myspace_url": "http://www.myspace.com/chrisisaak",
        "name": "Chris Isaak",
        "official_url": "http://www.chrisisaak.com/",
        "primary_genre_id": 27,
        "popularity": 0.0,
        "upcoming_events_count": 58,
        "updated_at": "2012-07-02T09:55:40Z",
        "wikipedia_url": "http://en.wikipedia.org/wiki/Chris_Isaak",
        "youtube_url": null,
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-thumbnail.jpg?1324556547",
          "medium": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-medium.jpg?1324556547",
          "large": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-large.jpg?1324556547",
          "mobile": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-mobile.jpg?1324556547"
        },
        "url": "http://thrillcall.com/artist/Chris_Isaak"
      },
      {
        ...
      },
      ...
    ]

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?
  • event_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
  • name_modified boolean Has the event name been modified?
  • featured_event boolean Is this a featured event?
  • venue_id integer Thrillcall Venue ID
  • venue hash Thrillcall Venue
  • photos hash A hash of image urls of the primary photo available for this object in different styles
  • artists array An array of hashes, each representing an artist at this event, containing:
    • id integer Thrillcall ID for the Event
    • name string Artist name
    • headliner boolean Is this artist a headliner on the bill?
    • 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
  • offer_details hash A hash of of attributes consisting of offer details about an offer attached to an event, if present
    • id integer Offer ID
    • title string Offer title
    • offer_starts_at string ISO 8601 representation of the start of the Offer in UTC time
    • offer_starts_at_local string ISO 8601 representation of the start of the Offer in local timezone
    • offer_end_at string ISO 8601 representation of the end of the Offer in UTC time
    • offer_starts_at_local string ISO 8601 representation of the end of the Offer in local timezone
    • offer_sale_starts_at string ISO 8601 representation of the start of the Offer sale in UTC time
    • offer_sale_starts_at_local string ISO 8601 representation of the start of the Offer sale in local timezone
    • short_description string Short description of the offer
    • offer_type string Type of the offer ( contest, standard )
    • price_cents integer Price of the offer in cents
    • photos hash A hash of offer photos (currently only returns 'mobile' style photos)

GET /events

Params:

Returns: Array of Events Hash

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

    [
      {
        "id": 1357825,
        "name": "San Francisco Symphony @ Davies Symphony Hall",
        "venue_id": 51886,
        "created_at": "2013-06-26T19:31:36Z",
        "updated_at": "2013-06-27T09:55:14Z",
        "festival": false,
        "rumor": false,
        "unconfirmed_location": 0,
        "latitude": 37.7774,
        "longitude": -122.42,
        "starts_at": "2014-05-15T03:00:00Z",
        "starts_at_time_trusted": true,
        "distance": 1.1199036357727454,
        "bearing": "220.0",
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/13019/1405/1324556969/san-francisco-symphony-thumbnail.jpg?1324556969",
          "large": "http://i1.tc-core.com/artist/13019/1405/1324556969/san-francisco-symphony-large.jpg?1324556969",
          "mobile": "http://i1.tc-core.com/artist/13019/1405/1324556969/san-francisco-symphony-mobile.jpg?1324556969"
        },
        "url": "http://thrillcall.com/event/1357825",
        "starts_at_local": "2014-05-14T20:00:00-07:00",
        "time_zone": "America/Los_Angeles",
        "event_status": "confirmed",
        "name_modified": false,
        "featured_event": false,
        "venue": {
          "id": 51886,
          "name": "Davies Symphony Hall",
          "address1": "201 Van Ness Avenue",
          "address2": null,
          "city": "San Francisco",
          "state": "CA",
          "official_url": "http://www.sfsymphony.org/",
          "created_at": "2008-04-28T17:59:32Z",
          "updated_at": "2013-10-20T09:06:01Z",
          "latitude": 37.777402,
          "longitude": -122.419815,
          "country_code": "US",
          "myspace_url": null,
          "upcoming_events_count": 93,
          "facebook_url": "http://www.facebook.com/sfsymphony",
          "long_description": null,
          "phone_number": "+1 (415) 864-6000",
          "time_zone": "America/Los_Angeles",
          "hide_resale_tickets": false,
          "wikipedia_url": null,
          "photos": {
            "thumbnail": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-thumbnail.jpg?1326417154",
            "medium": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-medium.jpg?1326417154",
            "large": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-large.jpg?1326417154",
            "mobile": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-mobile.jpg?1326417154"
          },
          "postalcode": "94102",
          "metro_area_id": 105,
          "ticket_providers": [
            {
              "id": 5637,
              "merchant_id": 22,
              "name": "IndieTickets",
              "url": "http://www.sfsymphony.org/season/calendar.aspx",
              "primary": true,
              "tier": 0,
              "display_index": 8,
              "image": "http://i1.tc-core.com/merchant/22/1324584355/20-full.jpg?1324584355"
            }
          ],
          "url": "http://thrillcall.com/venue/Davies_Symphony_Hall_in_San_Francisco_CA"
        },
        "artists": [
          {
            "id": 13019,
            "name": "San Francisco Symphony",
            "headliner": false,
            "photos": {
              "thumbnail": "http://i1.tc-core.com/artist/13019/1405/1324556969/san-francisco-symphony-thumbnail.jpg?1324556969",
              "medium": "http://i1.tc-core.com/artist/13019/1405/1324556969/san-francisco-symphony-medium.jpg?1324556969",
              "large": "http://i1.tc-core.com/artist/13019/1405/1324556969/san-francisco-symphony-large.jpg?1324556969",
              "mobile": "http://i1.tc-core.com/artist/13019/1405/1324556969/san-francisco-symphony-mobile.jpg?1324556969"
            }
          }
        ],
        "offer_details": null
      },
      {
        ...
      },
      ...
    ]

GET /event/:id

:id integer Thrillcall ID

Params:

  • None

Returns: Event Hash

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

    {
      "id": 1412491,
      "name": "Death Cab for Cutie @ McMenamins Edgefield Amphitheatre",
      "venue_id": 61956,
      "created_at": "2013-09-01T01:49:44Z",
      "updated_at": "2013-09-01T11:51:50Z",
      "festival": false,
      "rumor": false,
      "unconfirmed_location": 0,
      "latitude": 45.5384,
      "longitude": -122.408,
      "starts_at": "2014-09-01T01:30:00Z",
      "starts_at_time_trusted": true,
      "photos": {
        "thumbnail": "http://i1.tc-core.com/artist/8912/850/1324556811/death-cab-for-cutie-thumbnail.jpg?1324556811",
        "large": "http://i1.tc-core.com/artist/8912/850/1324556811/death-cab-for-cutie-large.jpg?1324556811",
        "mobile": "http://i1.tc-core.com/artist/8912/850/1324556811/death-cab-for-cutie-mobile.jpg?1324556811"
      },
      "url": "http://thrillcall.com/event/1412491",
      "starts_at_local": "2014-08-31T18:30:00-07:00",
      "time_zone": "America/Los_Angeles",
      "event_status": "confirmed",
      "name_modified": false,
      "featured_event": false,
      "venue": {
        "id": 61956,
        "name": "McMenamins Edgefield Amphitheatre",
        "address1": "2126 SW Halsey Street",
        "address2": null,
        "city": "Troutdale",
        "state": "OR",
        "official_url": "http://www.mcmenamins.com/54-edgefield-home",
        "created_at": "2009-03-25T20:57:27Z",
        "updated_at": "2013-09-22T09:59:13Z",
        "latitude": 45.538419,
        "longitude": -122.40831,
        "country_code": "US",
        "myspace_url": null,
        "upcoming_events_count": 1,
        "facebook_url": "http://www.facebook.com/pages/McMenamins-Edgefield/145274282244744",
        "long_description": null,
        "phone_number": "+1 (503) 669-8610",
        "time_zone": "America/Los_Angeles",
        "hide_resale_tickets": false,
        "wikipedia_url": null,
        "photos": {
          "thumbnail": "http://i1.tc-core.com/venue/_default/default-thumbnail.jpg",
          "medium": "http://i1.tc-core.com/venue/_default/default-medium.jpg",
          "large": "http://i1.tc-core.com/venue/_default/default-large.jpg",
          "mobile": "http://i1.tc-core.com/venue/_default/default-mobile.jpg"
        },
        "postalcode": "97060",
        "metro_area_id": 113,
        "ticket_providers": [
          {
            "id": 8893,
            "merchant_id": 20,
            "name": "eTix",
            "url": "https://www.etix.com/ticket/online/venueSearch.jsp?venue_id=7623&performance_id=1716840&cobrand=edgefieldconcerts&language=en&country=US",
            "primary": true,
            "tier": 0,
            "display_index": 10,
            "image": "http://i1.tc-core.com/merchant/20/1368590491/166-full.jpg?1368590500"
          }
        ],
        "url": "http://thrillcall.com/venue/McMenamins_Edgefield_Amphitheatre_in_Troutdale_OR"
      },
      "artists": [
        {
          "id": 8912,
          "name": "Death Cab for Cutie",
          "headliner": false,
          "photos": {
            "thumbnail": "http://i1.tc-core.com/artist/8912/850/1324556811/death-cab-for-cutie-thumbnail.jpg?1324556811",
            "medium": "http://i1.tc-core.com/artist/8912/850/1324556811/death-cab-for-cutie-medium.jpg?1324556811",
            "large": "http://i1.tc-core.com/artist/8912/850/1324556811/death-cab-for-cutie-large.jpg?1324556811",
            "mobile": "http://i1.tc-core.com/artist/8912/850/1324556811/death-cab-for-cutie-mobile.jpg?1324556811"
          }
        }
      ],
      "offer_details": {
        "id": 123,
        "title": "Example Offer",
        "offer_starts_at": "2013-05-01T09:00:00-07:00",
        "offer_starts_at_local": "2013-05-01T09:00:00-07:00",
        "offer_ends_at": "2013-05-02T17:00:00-07:00",
        "offer_ends_at_local": "2013-05-02T17:00:00-07:00",
        "offer_sale_starts_at": "2013-05-01T09:00:00-07:00",
        "offer_sale_starts_at_local": "2013-05-01T09:00:00-07:00",
        "short_description": "Get tickets for tonight!",
        "offer_type": "standard",
        "price_cents": 2000
      }
    }

GET /event/:id/artists

:id integer Thrillcall ID

Params:

Returns: Array of Artists Hash

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

    [
      {
        "created_at": "2008-04-21T16:53:17Z",
        "facebook_url": null,
        "genre_tags": "acoustic;Country;Rock;rockabilly",
        "id": 12569,
        "myspace_url": "http://www.myspace.com/chrisisaak",
        "name": "Chris Isaak",
        "official_url": "http://www.chrisisaak.com/",
        "primary_genre_id": 27,
        "popularity": 0.0,
        "upcoming_events_count": 58,
        "updated_at": "2012-07-02T09:55:40Z",
        "wikipedia_url": "http://en.wikipedia.org/wiki/Chris_Isaak",
        "youtube_url": null,
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-thumbnail.jpg?1324556547",
          "medium": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-medium.jpg?1324556547",
          "large": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-large.jpg?1324556547",
          "mobile": "http://i1.tc-core.com/artist/12569/657/1324556547/chris-isaak-mobile.jpg?1324556547"
        },
        "url": "http://thrillcall.com/artist/Chris_Isaak"
      },
      {
        ...
      },
      ...
    ]

GET /event/:id/venue

:id integer Thrillcall ID

Params:

Returns: Venue Hash

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

    {
      "id": 63279,
      "name": "Masonic Center",
      "address1": "1111 California Street",
      "address2": null,
      "city": "San Francisco",
      "state": "CA",
      "official_url": "http://www.masonicauditorium.com/",
      "created_at": "2009-08-25T19:25:27Z",
      "updated_at": "2013-10-19T09:54:04Z",
      "latitude": 37.79153,
      "longitude": -122.412757,
      "country_code": "US",
      "myspace_url": "http://www.myspace.com/masonicauditorium",
      "upcoming_events_count": 4,
      "facebook_url": "http://www.facebook.com/pages/Nob-Hill-Masonic-Center/152483968103491",
      "long_description": null,
      "phone_number": "+1 (877) 598-8497",
      "time_zone": "America/Los_Angeles",
      "hide_resale_tickets": false,
      "wikipedia_url": null,
      "photos": {
        "thumbnail": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-thumbnail.jpg?1326419135",
        "medium": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-medium.jpg?1326419135",
        "large": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-large.jpg?1326419135",
        "mobile": "http://i1.tc-core.com/venue/63279/87/1326419135/masonic-center-in-san-francisco-ca-mobile.jpg?1326419135"
      },
      "postalcode": "94108",
      "metro_area_id": 105,
      "ticket_providers": [
        {
          "id": 3001,
          "merchant_id": 2,
          "name": "Ticketmaster",
          "url": "http://ticketsus.at/thrillcall/229776.html",
          "primary": true,
          "tier": 0,
          "display_index": 0,
          "image": "http://i1.tc-core.com/merchant/2/1324584352/2-full.jpg?1324584352"
        },
        {
          "id": 5386,
          "merchant_id": 22,
          "name": "IndieTickets",
          "url": "http://www.masonicauditorium.com/calendar/index.html",
          "primary": true,
          "tier": 0,
          "display_index": 8,
          "image": "http://i1.tc-core.com/merchant/22/1324584355/20-full.jpg?1324584355"
        }
      ],
      "url": "http://thrillcall.com/venue/Masonic_Center_in_San_Francisco_CA"
    }

GET /event/:id/tickets

:id integer Thrillcall ID

Params:

Returns: Array of Tickets Hash

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

    [
      {
        "created_at": "2012-03-02T18:06:14Z",
        "currency": "USD",
        "description": null,
        "event_id": 1047075,
        "id": 819883,
        "marketing_text": null,
        "max_ticket_price": "85.00",
        "min_ticket_price": "29.00",
        "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:

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:

Returns: Array of Artists Hash

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

    [
      {
        "created_at": "2008-04-29T10:06:05Z",
        "facebook_url": null,
        "genre_tags": "Folk;Other;psychedelic",
        "id": 2,
        "myspace_url": "http://www.myspace.com/espers",
        "name": "Espers",
        "official_url": "http://www.espers.org",
        "primary_genre_id": 27,
        "popularity": 0.0,
        "upcoming_events_count": 1,
        "updated_at": "2012-05-31T09:16:49Z",
        "wikipedia_url": "http://en.wikipedia.org/wiki/index.html?curid=4735724",
        "youtube_url": null,
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/2/15306/1328344246/espers-thumbnail.jpg?1328344246",
          "medium": "http://i1.tc-core.com/artist/2/15306/1328344246/espers-medium.jpg?1328344246",
          "large": "http://i1.tc-core.com/artist/2/15306/1328344246/espers-large.jpg?1328344246",
          "mobile": "http://i1.tc-core.com/artist/2/15306/1328344246/espers-mobile.jpg?1328344246"
        },
        "url": "http://thrillcall.com/artist/Espers"
      },
      {
        ...
      },
      ...
    ]

Metro Area

Fields:

  • city string City of the Metro Area
  • country_code 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:

Returns: Array of Metro Areas Hash

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

    [
      {
        "city": "Chicago",
        "country_code": "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_code": "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:

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-06-20&max_date=2012-06-19&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",
        "rumor": false,
        "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://i1.tc-core.com/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-thumbnail.jpg?1326489566",
          "large": "http://i1.tc-core.com/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-large.jpg?1326489566",
          "mobile": "http://i1.tc-core.com/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",
        "event_status": "confirmed",
        "name_modified": false,
        "featured_event": false,
        "venue": {
          "address2":null,"city":"San Francisco",
          "country_code":"US",
          "created_at":"2008-04-28T18:13:50Z",
          "facebook_url":"http://www.facebook.com/theendup",
          "hide_resale_tickets":false,
          "id":47273,
          "latitude":37.777243,
          "long_description":null,
          "longitude":-122.403919,
          "myspace_url":null,
          "name":"The End Up",
          "official_url":"http://www.theendup.com",
          "phone_number":"+1 (415) 896-1075",
          "state":"CA",
          "time_zone":"America/Los_Angeles",
          "upcoming_events_count":5,
          "updated_at":"2012-08-19T11:29:19Z",
          "postalcode":"94708",
          "photos":{"thumbnail":"http://i1.tc-core.com/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-thumbnail.jpg?1326489566",
          "medium":"http://i1.tc-core.com/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-medium.jpg?1326489566",
          "large":"http://i1.tc-core.com/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-large.jpg?1326489566",
          "mobile":"http://i1.tc-core.com/noel/venue/47273/107/1326489566/the-end-up-in-san-francisco-ca-mobile.jpg?1326489566"},
          "metro_area_id":105,
          "url":"http://localhost:3000/venue/The_End_Up_in_San_Francisco_CA"
        },
        "artists": [
          {
            "id": 2295,
            "name": "Kontrol",
            "headliner": false
          }
        ],
        "offer_details": {}
      },
      {
        ...
      },
      ...
    ]

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
  • preferred_radius float Preference for radius in miles from the Person to search for events for that Person
  • alert_email boolean Preference for receiving email alerts for that Person

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",
      "credentials": [
        {
          "id": 18434,
          "provider": "facebook",
          "uid": "abc123",
          "token_present": true
        }
      ]
      "first_name": "John",
      "gender": "m",
      "alert_email": true,
      "id": 49,
      "last_name": "Doe",
      "login": "bogus@bogus.com",
      "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://i1.tc-core.com/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
        "thumbnail": "http://i1.tc-core.com/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
        "medium": "http://i1.tc-core.com/person/164761/1324568419/19154-medium.jpg?1324568419"
      },
      "preferred_radius": 100.0
    }

POST /person/signin

Params:

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,
      "credentials": [
        {
          "id": 18434,
          "provider": "facebook",
          "uid": "abc123",
          "token_present": true
        }
      ]
      "first_name": "Mister",
      "gender": null,
      "alert_email": true,
      "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://i1.tc-core.com/person/_default/default-small_thumb.jpg",
        "thumbnail": "http://i1.tc-core.com/person/_default/default-thumbnail.jpg",
        "medium": "http://i1.tc-core.com/person/_default/default-medium.jpg"
      },
      "preferred_radius": 100.0
    }

POST /person/signup

Params:

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,
      "credentials": [
        {
          "id": 18434,
          "provider": "facebook",
          "uid": "abc123",
          "token_present": true
        }
      ]
      "first_name": "Mister",
      "gender": null,
      "alert_email": true,
      "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://i1.tc-core.com/person/_default/default-small_thumb.jpg",
        "thumbnail": "http://i1.tc-core.com/person/_default/default-thumbnail.jpg",
        "medium": "http://i1.tc-core.com/person/_default/default-medium.jpg"
      },
      "preferred_radius": 100.0
    }

PUT /person/:id

Params:

Returns: Person Hash

    // Example: PUT /api/v3/person/49&first_name=John&api_key=1234567890abcdef

    {
      "address1": null,
      "address2": null,
      "city": "Santa Rosa",
      "country_code": "US",
      "created_at": "2011-10-17T18:54:31Z",
      "credentials": [
        {
          "id": 18434,
          "provider": "facebook",
          "uid": "abc123",
          "token_present": true
        }
      ]
      "first_name": "John",
      "gender": "m",
      "alert_email": true,
      "id": 49,
      "last_name": "Doe",
      "login": "bogus@bogus.com",
      "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://i1.tc-core.com/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
        "thumbnail": "http://i1.tc-core.com/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
        "medium": "http://i1.tc-core.com/person/164761/1324568419/19154-medium.jpg?1324568419"
      },
      "preferred_radius": 100.0
    }

POST /person/:id/photo

Params:

Uploads a new profile photo. Replaces the old photo, if any.

Returns: Person Hash

  // Example: POST /api/v3/person/49 api_key=1234567890abcdef file=@/myphoto.jpg

  {
    "address1": null,
    "address2": null,
    "city": "Santa Rosa",
    "country_code": "US",
    "created_at": "2011-10-17T18:54:31Z",
    "credentials": [
      {
        "id": 18434,
        "provider": "facebook",
        "uid": "abc123",
        "token_present": true
      }
    ]
    "first_name": "John",
    "gender": "m",
    "alert_email": true,
    "id": 49,
    "last_name": "Doe",
    "login": "bogus@bogus.com",
    "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://i1.tc-core.com/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
      "thumbnail": "http://i1.tc-core.com/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
      "medium": "http://i1.tc-core.com/person/164761/1324568419/19154-medium.jpg?1324568419"
    },
    "preferred_radius": 100.0
  }

GET /people/tracking/:class

:class string One of: "genres", "events", "artists", "people", "venues"

Params:

Returns: Array of Hash containing id, name, and count for each tracked :class ordered by count descending.

    // Example: GET /api/v3/people/tracking/artist?ids=2,4,321&api_key=1234567890abcdef

    [
      {
        "name": "M83",
        "count": 3,
        "id": 18927
      },
      {
        "name": "Radiohead",
        "count": 2,
        "id": 2687
      },
      ...
    ]

GET /person/:id/:class

:class string One of: "genres", "events", "artists", "people", "venues"

Params:

  • None.

Returns: Hash of tracked :class IDs mapped to :class names for this person.

    // Example: GET /api/v3/person/2/artists&api_key=1234567890abcdef

    {
      "2687": "Radiohead",
      "18927": "M83",
      ...
    }

POST /person/:id/:action/:class

:action string One of: "track", "untrack" :class string One of: "genres", "events", "artists", "people", "venues"

Params:

Returns: Hash of :class tracked IDs mapped for this person after performing :action.

    // Example: POST /api/v3/person/24/track/artists?ids=44,45&platform=ios&api_key=1234567890abcdef

    {
      "44": "Paco Osuna",
      "45": "Wanamaker"
    }

POST /person/:id/track_artists_by_name

Params:

Returns: Array of hash with tracked artist IDs mapped to artist names for this person.

    // Example: POST /api/v3/person/24/track_artists_by_name?artist_names=Radiohead,M83&platform=ios&api_key=1234567890abcdef

    [
      {
        "2687": "Radiohead"
      },
      {
        "18927": "M83",
      }
    ]

GET /person/:id/recommended_events

:id integer Thrillcall ID

Params:

Note: By default, this will search for events within the Person's preferred_radius of the Person's geolocation. You may override these defaults with lat/long or postalcode and radius.

Returns: Array of Events Hash where at least one of the person's tracked artists is performing in an event

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

    [
      {
        "id": 1462160,
        "name": "Mogwai @ Roseland Theater",
        "venue_id": 47425,
        "created_at": "2014-03-24T22:34:54Z",
        "updated_at": "2014-03-24T22:34:54Z",
        "festival": false,
        "rumor": false,
        "unconfirmed_location": 0,
        "latitude": 45.5232,
        "longitude": -122.676,
        "starts_at": "2014-05-25T04:00:00Z",
        "starts_at_time_trusted": true,
        "distance": 1.6921186893745308,
        "bearing": "286.0",
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/12978/189/1324556247/mogwai-thumbnail.jpg?1324556247",
          "large": "http://i1.tc-core.com/artist/12978/189/1324556247/mogwai-large.jpg?1324556247",
          "mobile": "http://i1.tc-core.com/artist/12978/189/1324556247/mogwai-mobile.jpg?1324556247"
        },
        "url": "http://thrillcall.com/event/1462160",
        "starts_at_local": "2014-05-24T21:00:00-07:00",
        "time_zone": "America/Los_Angeles",
        "event_status": "confirmed",
        "name_modified": false,
        "featured_event": false,
        "venue": {
          "id": 47425,
          "name": "Roseland Theater",
          "address1": "8 NW 6th Ave",
          "address2": null,
          "city": "Portland",
          "state": "OR",
          "official_url": "http://www.roselandpdx.com/",
          "created_at": "2008-05-08T17:00:43Z",

      "updated_at": "2013-10-22T09:06:18Z",
          "latitude": 45.523226,
          "longitude": -122.676378,
          "country_code": "US",
          "myspace_url": "http://www.myspace.com/roselandtheater",
          "upcoming_events_count": 28,
          "facebook_url": "http://www.facebook.com/roselandtheater",
          "long_description": null,
          "phone_number": "+1 (503) 224-8499",
          "time_zone": "America/Los_Angeles",
          "hide_resale_tickets": false,
          "wikipedia_url": null,
          "photos": {
            "thumbnail": "http://i1.tc-core.com/venue/47425/2783/1364254379/roseland-theater-in-portland-or-thumbnail.jpg?1364254379",
            "medium": "http://i1.tc-core.com/venue/47425/2783/1364254379/roseland-theater-in-portland-or-medium.jpg?1364254379",
            "large": "http://i1.tc-core.com/venue/47425/2783/1364254379/roseland-theater-in-portland-or-large.jpg?1364254379",
            "mobile": "http://i1.tc-core.com/venue/47425/2783/1364254379/roseland-theater-in-portland-or-mobile.jpg?1364254379"
          },
          "postalcode": "97209",
          "metro_area_id": 113,
          "ticket_providers": [
            {
              "id": 371,
              "merchant_id": 21,
              "name": "TicketsWest",
              "url": "http://ticketswest.rdln.com/Venue.aspx?ven=PC-ROS",
              "primary": true,
              "tier": 0,
              "display_index": 9,
              "image": "http://i1.tc-core.com/merchant/21/1324584355/19-full.jpg?1324584355"
            },
            {
              "id": 8753,
              "merchant_id": 36,
              "name": "AXS",
              "url": "http://www.axs.com/venues/102035/roseland-theater-portland-tickets",
              "primary": true,
              "tier": 0,
              "display_index": 33,
              "image": "http://i1.tc-core.com/merchant/36/1365101348/162-full.jpg?1365101348"
            }
          ],
          "url": "http://thrillcall.com/venue/Roseland_Theater_in_Portland_OR"
        },
        "artists": [
          {
            "id": 12978,
            "name": "Mogwai",
            "headliner": false,
            "photos": {
              "thumbnail": "http://i1.tc-core.com/artist/12978/189/1324556247/mogwai-thumbnail.jpg?1324556247",
              "medium": "http://i1.tc-core.com/artist/12978/189/1324556247/mogwai-medium.jpg?1324556247",
              "large": "http://i1.tc-core.com/artist/12978/189/1324556247/mogwai-large.jpg?1324556247",
              "mobile": "http://i1.tc-core.com/artist/12978/189/1324556247/mogwai-mobile.jpg?1324556247"
            }
          }
        ],
        "offer_details": null
      },
      {
        ...
      },
      ...
    ]

GET /person/:id/friends_events

:id integer Thrillcall ID

Params:

  • None.

Returns: Array of Hashes containing Person Hash keyed on "friend" and Array of Event IDs keyed on "events"

All people in the result set are friends (tracked Person objects) of the Person.

Event IDs are future active events tracked by that friend.

    // Example: GET /api/v3/person/2/friends_events&api_key=1234567890abcdef

    [
      {
        "friend": {
          "address1": null,
          "address2": null,
          "city": "Santa Rosa",
          "country_code": "US",
          "created_at": "2011-10-17T18:54:31Z",
          "credentials": [
            {
              "id": 18434,
              "provider": "facebook",
              "uid": "abc123",
              "token_present": true
            }
          ]
          "first_name": "John",
          "gender": "m",
          "alert_email": true,
          "id": 49,
          "last_name": "Doe",
          "login": "bogus@bogus.com",
          "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://i1.tc-core.com/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
            "thumbnail": "http://i1.tc-core.com/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
            "medium": "http://i1.tc-core.com/person/164761/1324568419/19154-medium.jpg?1324568419"
          },
          "preferred_radius": 100.0
        },
        "events": [
          1308413,
          ...
        ],
        ...
      }
    ]

GET /person/:id/recommended_artists

:id integer Thrillcall ID

Params:

Returns: Hash The hash will contain the following keys.

  • recommendations: For each service and popular artists, an Array of recommended artist Hashes. If there is any error with the connection, an error message string to present to the user will be here instead of the array.
  • connected: For each service, boolean whether or not the user is connected
  • autotrack: For each service, boolean whether or not the user is automatically tracking recommended artists

In the recommendations hash, each artist is represented by a hash of the following key-value pairs:

  • id: Thrillcall ID
  • title: Name of the Artist
  • tracking: Boolean value indicating whether or not the user is tracking the Artist
  • artist_normalized_name
  • artist_upcoming_shows: The number of upcoming shows for this Artist
  • url: Artist photo URL
    // Example: GET /api/v3/person/2/recommended_artists?api_key=1234567890abcdef

    {
      "recommendations": {
        "popular": [
          {
            "id": 17053,
            "title": "Justin Timberlake",
            "tracking": false,
            "artist_normalized_name": "justintimberlake",
            "artist_upcoming_shows": 70,
            "url": "http://i1.tc-core.com/artist/17053/1048/1324556871/justin-timberlake-medium.jpg?1324556871"
          },
          {
            ...
          },
          ...
        ],
        "facebook": [
          ...
        ],
        "pandora": "Failure: No Pandora user found named 'bogususername'.",
        ...
      },
      "connected": {
        "facebook": true,
        "pandora": false,
        ...
      },
      "autotrack": {
        "facebook": false,
        ...
      }
    }

Credentials

Fields:

N/A. Always returns Person objects. Credentials are nested inside Person objects.

POST /credential

Params:

Returns: Person Hash

Credentials are stored tokens allowing us to authenticate on behalf of a Person. These are typically OAuth tokens, but can take any form. The token itself is not required and may be left blank, the other parameters are required.

    // Example: POST /api/v3/credential
    // person_id=49&provider=spotify&uid=4321&token=abc123&api_key=1234567890abcdef

    {
      "address1": null,
      "address2": null,
      "city": "Santa Rosa",
      "country_code": "US",
      "created_at": "2011-10-17T18:54:31Z",
      "credentials": [
        {
          "id": 18435,
          "provider": "spotify",
          "uid": "4321",
          "token_present": true
        }
      ]
      "first_name": "John",
      "gender": "m",
      "alert_email": true,
      "id": 49,
      "last_name": "Doe",
      "login": "bogus@bogus.com",
      "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://i1.tc-core.com/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
        "thumbnail": "http://i1.tc-core.com/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
        "medium": "http://i1.tc-core.com/person/164761/1324568419/19154-medium.jpg?1324568419"
      },
      "preferred_radius": 100.0
    }

PUT /credential/:id

:id integer Thrillcall ID

Params:

Returns: Person Hash

This endpoint allows you to change the UID or token of an existing credential. You must supply either the user's current password, or the existing token on the credential.

    // Example: PUT /api/v3/credential/18435
    // old_token=abc123&token=&api_key=1234567890abcdef

    {
      "address1": null,
      "address2": null,
      "city": "Santa Rosa",
      "country_code": "US",
      "created_at": "2011-10-17T18:54:31Z",
      "credentials": [
        {
          "id": 18435,
          "provider": "spotify",
          "uid": "4321",
          "token_present": false
        }
      ]
      "first_name": "John",
      "gender": "m",
      "alert_email": true,
      "id": 49,
      "last_name": "Doe",
      "login": "bogus@bogus.com",
      "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://i1.tc-core.com/person/164761/1324568419/19154-small_thumb.jpg?1324568419",
        "thumbnail": "http://i1.tc-core.com/person/164761/1324568419/19154-thumbnail.jpg?1324568419",
        "medium": "http://i1.tc-core.com/person/164761/1324568419/19154-medium.jpg?1324568419"
      },
      "preferred_radius": 100.0
    }

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_code 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
  • ticket_providers array List of standard ticket providers for this Venue
    • id integer Thrillcall ID of the Ticket Provider
    • merchant_id integer Thrillcall ID of the Merchant
    • name string Name of the Merchant
    • url string Generic ticketing link for this Venue from this Merchant
    • primary boolean Whether or not the merchant is a primary ticket source
    • tier integer Display tier relative to other Merchants
    • display_index integer Display index relative to other Merchants in this tier
    • image string Thumbnail image URL for this Merchant
  • 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:

Returns: Array of Venues Hash

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

    [
      {
        "id": 62514,
        "name": "Colorado Convention Center",
        "address1": "702 14th Street",
        "address2": null,
        "city": "Denver",
        "state": "CO",
        "official_url": "http://denverconvention.com/",
        "created_at": "2009-08-25T19:10:02Z",
        "updated_at": "2013-01-01T10:04:20Z",
        "latitude": 39.743376,
        "longitude": -104.9948,
        "country_code": "US",
        "myspace_url": null,
        "upcoming_events_count": 0,
        "facebook_url": null,
        "long_description": null,
        "phone_number": null,
        "time_zone": "America/Denver",
        "hide_resale_tickets": false,
        "wikipedia_url": null,
        "photos": {
          "thumbnail": "http://i1.tc-core.com/venue/_default/default-thumbnail.jpg",
          "medium": "http://i1.tc-core.com/venue/_default/default-medium.jpg",
          "large": "http://i1.tc-core.com/venue/_default/default-large.jpg",
          "mobile": "http://i1.tc-core.com/venue/_default/default-mobile.jpg"
        },
        "postalcode": "80202",
        "metro_area_id": 114,
        "ticket_providers": [],
        "url": "http://thrillcall.com/venue/Colorado_Convention_Center_in_Denver_CO"
      },
      {
        ...
      },
      ...
    ]

POST /venue

Params:

Returns: Venue Hash

    // Example: POST /api/v3/venue?name=Test%20Venue&city=Guerneville&state=CA&country_code=US&address1=123%20Main%20St&postalcode=95446&api_key=1234567890abcdef

    {
      "address1": "123 Main St",
      "address2": null,
      "city": "Guerneville",
      "country_code": "US",
      "created_at": "2012-08-14T00:15:23Z",
      "facebook_url": null,
      "hide_resale_tickets": false,
      "id": 108951,
      "latitude": 38.50223159790039,
      "long_description": null,
      "longitude": -122.99627685546875,
      "myspace_url": null,
      "name": "Test Venue",
      "official_url": null,
      "phone_number": null,
      "state": "CA",
      "time_zone": "America/Los_Angeles",
      "upcoming_events_count": 0,
      "updated_at": "2012-08-14T00:15:23Z",
      "postalcode": "95446",
      "photos": {
        "thumbnail": "http://i1.tc-core.com/venue/_default/default-thumbnail.jpg",
        "medium": "http://i1.tc-core.com/venue/_default/default-medium.jpg",
        "large": "http://i1.tc-core.com/venue/_default/default-large.jpg",
        "mobile": "http://i1.tc-core.com/venue/_default/default-mobile.jpg"
      },
      "ticket_providers": [],
      "metro_area_id": null,
      "url": "http://thrillcall.com/venue/Test_Venue_in_Guerneville_CA"
    }

GET /venue/:id

:id integer Thrillcall or Mapping

Params:

  • None

Returns: Venue Hash

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

    {
      "id": 707,
      "name": "Long Center for the Performing Arts",
      "address1": "701 West Riverside Drive",
      "address2": null,
      "city": "Austin",
      "state": "TX",
      "official_url": "http://www.thelongcenter.org/",
      "created_at": "2008-06-07T02:38:31Z",
      "updated_at": "2014-04-11T17:45:30Z",
      "latitude": 30.259983,
      "longitude": -97.751122,
      "country_code": "US",
      "myspace_url": "http://www.myspace.com/thelongcenter",
      "upcoming_events_count": 0,
      "facebook_url": "http://www.facebook.com/pages/Long-Center-for-the-Performing-Arts/144535154289?ref=ts",
      "long_description": null,
      "phone_number": "+1 (512) 474-5664",
      "time_zone": "America/Chicago",
      "hide_resale_tickets": false,
      "wikipedia_url": null,
      "photos": {
        "thumbnail": "http://i1.tc-core.com/venue/707/762/1329867211/long-center-for-the-performing-arts-austin-tx-thumbnail.jpg?1329867211",
        "medium": "http://i1.tc-core.com/venue/707/762/1329867211/long-center-for-the-performing-arts-austin-tx-medium.jpg?1329867211",
        "large": "http://i1.tc-core.com/venue/707/762/1329867211/long-center-for-the-performing-arts-austin-tx-large.jpg?1329867211",
        "mobile": "http://i1.tc-core.com/venue/707/762/1329867211/long-center-for-the-performing-arts-austin-tx-mobile.jpg?1329867211"
      },
      "postalcode": "78704",
      "metro_area_id": 106,
      "ticket_providers": [
        {
          "id": 3609,
          "merchant_id": 2,
          "name": "Ticketmaster",
          "url": "http://ticketsus.at/thrillcall/99165.html",
          "primary": true,
          "tier": 0,
          "display_index": 0,
          "image": "http://i1.tc-core.com/merchant/2/1324584352/2-full.jpg?1324584352"
        },
        ...
      ],
      "url": "http://localhost:3000/venue/Long-Center-for-the-Performing-Arts-Austin-TX?utm_source=thrillcall-mobile-app-never-remove&utm_medium=venue_707_long-center-for-the-performing-arts-austin-tx&utm_campaign=venue_707"
    }

PUT /venue/:id

Params:

Returns: Venue Hash

    // Example: PUT /api/v3/venue/51886?address1=202%20Van%20Ness%20Avenue&api_key=1234567890abcdef

    {
      "id": 51886,
      "name": "Davies Symphony Hall",
      "address1": "202 Van Ness Avenue",
      "address2": null,
      "city": "San Francisco",
      "state": "CA",
      "official_url": "http://www.sfsymphony.org/",
      "created_at": "2008-04-28T17:59:32Z",
      "updated_at": "2013-10-20T09:06:01Z",
      "latitude": 37.777402,
      "longitude": -122.419815,
      "country_code": "US",
      "myspace_url": null,
      "upcoming_events_count": 93,
      "facebook_url": "http://www.facebook.com/sfsymphony",
      "long_description": null,
      "phone_number": "+1 (415) 864-6000",
      "time_zone": "America/Los_Angeles",
      "hide_resale_tickets": false,
      "wikipedia_url": null,
      "photos": {
        "thumbnail": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-thumbnail.jpg?1326417154",
        "medium": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-medium.jpg?1326417154",
        "large": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-large.jpg?1326417154",
        "mobile": "http://i1.tc-core.com/venue/51886/74/1326417154/davies-symphony-hall-in-san-francisco-ca-mobile.jpg?1326417154"
      },
      "postalcode": "94102",
      "metro_area_id": 105,
      "ticket_providers": [
        {
          "id": 5637,
          "merchant_id": 22,
          "name": "IndieTickets",
          "url": "http://www.sfsymphony.org/season/calendar.aspx",
          "primary": true,
          "tier": 0,
          "display_index": 8,
          "image": "http://i1.tc-core.com/merchant/22/1324584355/20-full.jpg?1324584355"
        }
      ],
      "url": "http://thrillcall.com/venue/Davies_Symphony_Hall_in_San_Francisco_CA"
    }

GET /venue/:id/events

:id integer Thrillcall or Mapping

Params:

Returns: Array of Events Hash

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

    [
      {
        "id": 1257609,
        "name": "Emanuel Ax @ Carnegie Hall",
        "venue_id": 1904,
        "created_at": "2013-02-06T09:08:46Z",
        "updated_at": "2013-09-05T04:03:17Z",
        "festival": false,
        "rumor": false,
        "unconfirmed_location": 0,
        "latitude": 40.765,
        "longitude": -73.9799,
        "starts_at": "2014-05-16T00:00:00Z",
        "starts_at_time_trusted": true,
        "photos": {
          "thumbnail": "http://i1.tc-core.com/artist/37241/1509/1324556998/emanuel-ax-thumbnail.jpg?1324556998",
          "large": "http://i1.tc-core.com/artist/37241/1509/1324556998/emanuel-ax-large.jpg?1324556998",
          "mobile": "http://i1.tc-core.com/artist/37241/1509/1324556998/emanuel-ax-mobile.jpg?1324556998"
        },
        "url": "http://thrillcall.com/event/1257609",
        "starts_at_local": "2014-05-15T20:00:00-04:00",
        "time_zone": "America/New_York",
        "event_status": "confirmed",
        "name_modified": false,
        "featured_event": false,
        "venue": {
          "id": 1904,
          "name": "Carnegie Hall",
          "address1": "881 Seventh Avenue",
          "address2": null,
          "city": "New York",
          "state": "NY",
          "official_url": "http://www.carnegiehall.org/",
          "created_at": "2008-05-08T17:17:11Z",
          "updated_at": "2014-04-11T18:42:42Z",
          "latitude": 40.765018,
          "longitude": -73.979912,
          "country_code": "US",
          "myspace_url": null,
          "upcoming_events_count": 101,
          "facebook_url": "http://www.facebook.com/carnegiehall",
          "long_description": null,
          "phone_number": "+1 (212) 247-7800",
          "time_zone": "America/New_York",
          "hide_resale_tickets": false,
          "wikipedia_url": null,
          "photos": {
            "thumbnail": "http://i1.tc-core.com/venue/1904/716/1329527604/carnegie-hall-new-york-ny-thumbnail.jpg?1329527604",
            "medium": "http://i1.tc-core.com/venue/1904/716/1329527604/carnegie-hall-new-york-ny-medium.jpg?1329527604",
            "large": "http://i1.tc-core.com/venue/1904/716/1329527604/carnegie-hall-new-york-ny-large.jpg?1329527604",
            "mobile": "http://i1.tc-core.com/venue/1904/716/1329527604/carnegie-hall-new-york-ny-mobile.jpg?1329527604"
          },
          "postalcode": "10019",
          "metro_area_id": 107,
          "ticket_providers": [
            {
              "id": 3580,
              "merchant_id": 2,
              "name": "Ticketmaster",
              "url": "http://ticketsus.at/thrillcall/219.html",
              "primary": true,
              "tier": 0,
              "display_index": 0,
              "image": "http://i1.tc-core.com/merchant/2/1324584352/2-full.jpg?1324584352"
            },
            {
              "id": 5658,
              "merchant_id": 22,
              "name": "IndieTickets",
              "url": "http://www.carnegiehall.org/Calendar/",
              "primary": true,
              "tier": 0,
              "display_index": 8,
              "image": "http://i1.tc-core.com/merchant/22/1324584355/20-full.jpg?1324584355"
            }
          ],
          "url": "http://thrillcall.com/venue/Carnegie-Hall-New-York-NY"
        },
        "artists": [
          {
            "id": 37241,
            "name": "Emanuel Ax",
            "headliner": false,
            "photos": {
              "thumbnail": "http://i1.tc-core.com/artist/37241/1509/1324556998/emanuel-ax-thumbnail.jpg?1324556998",
              "medium": "http://i1.tc-core.com/artist/37241/1509/1324556998/emanuel-ax-medium.jpg?1324556998",
              "large": "http://i1.tc-core.com/artist/37241/1509/1324556998/emanuel-ax-large.jpg?1324556998",
              "mobile": "http://i1.tc-core.com/artist/37241/1509/1324556998/emanuel-ax-mobile.jpg?1324556998"
            }
          }
        ],
        "offer_details": null
      },
      {
        ...
      },
      ...
    ]

GET /search/venues/:term

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

Params:

Returns: Array of Venues Hash

    // Example: GET /api/v3/search/venues/Carnegie?api_key=1234567890abcdef

    [
      {
        "id": 1904,
        "name": "Carnegie Hall",
        "address1": "881 Seventh Avenue",
        "address2": null,
        "city": "New York",
        "state": "NY",
        "official_url": "http://www.carnegiehall.org/",
        "created_at": "2008-05-08T17:17:11Z",
        "updated_at": "2014-04-11T18:42:42Z",
        "latitude": 40.765018,
        "longitude": -73.979912,
        "country_code": "US",
        "myspace_url": null,
        "upcoming_events_count": 101,
        "facebook_url": "http://www.facebook.com/carnegiehall",
        "long_description": null,
        "phone_number": "+1 (212) 247-7800",
        "time_zone": "America/New_York",
        "hide_resale_tickets": false,
        "wikipedia_url": null,
        "photos": {
          "thumbnail": "http://i1.tc-core.com/venue/1904/716/1329527604/carnegie-hall-new-york-ny-thumbnail.jpg?1329527604",
          "medium": "http://i1.tc-core.com/venue/1904/716/1329527604/carnegie-hall-new-york-ny-medium.jpg?1329527604",
          "large": "http://i1.tc-core.com/venue/1904/716/1329527604/carnegie-hall-new-york-ny-large.jpg?1329527604",
          "mobile": "http://i1.tc-core.com/venue/1904/716/1329527604/carnegie-hall-new-york-ny-mobile.jpg?1329527604"
        },
        "postalcode": "10019",
        "metro_area_id": 107,
        "ticket_providers": [
          {
            "id": 3580,
            "merchant_id": 2,
            "name": "Ticketmaster",
            "url": "http://ticketsus.at/thrillcall/219.html",
            "primary": true,
            "tier": 0,
            "display_index": 0,
            "image": "http://i1.tc-core.com/merchant/2/1324584352/2-full.jpg?1324584352"
          },
          {
            "id": 5658,
            "merchant_id": 22,
            "name": "IndieTickets",
            "url": "http://www.carnegiehall.org/Calendar/",
            "primary": true,
            "tier": 0,
            "display_index": 8,
            "image": "http://i1.tc-core.com/merchant/22/1324584355/20-full.jpg?1324584355"
          }
        ],
        "url": "http://thrillcall.com/venue/Carnegie-Hall-New-York-NY"
      },
      {
        ...
      },
      ...
    ]

Tickets

Fields:

  • created_at string ISO 8601 representation the time this object was created
  • currency string Currency of the price
  • 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 string Maximum price for this ticket
  • min_ticket_price string 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:

Returns: Array of Tickets Hash

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

    [
      {
        "created_at": "2008-12-06T00:19:59Z",
        "currency": "USD",
        "description": null,
        "event_id": 455646,
        "id": 1,
        "marketing_text": null,
        "max_ticket_price": "0.00",
        "min_ticket_price": "0.00",
        "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",
      "currency": "USD",
      "description": null,
      "event_id": 1047075,
      "id": 819883,
      "marketing_text": null,
      "max_ticket_price": "85.00",
      "min_ticket_price": "29.00",
      "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=]"
    }

Mappings

Mappings provide a translation between a Thrillcall ID and an ID from another source (partner).

They are used in place of IDs in the following format:

  partner_name:obj_type:partner_id

For example:

  GET /artist/myspace:artist:alicia_keys

Fields:

  • created_at string ISO 8601 representation the time this object was created
  • id integer Thrillcall ID of the mapping, not the referenced object
  • obj_type integer Type of the referenced object, e.g. "artist"
  • partner_display_name string The name of the object according to the partner, if different
  • partner_id string The name of the partner for this foreign mapping, e.g. "myspace"
  • partner_obj_id string Partner's ID for the referenced object
  • tc_obj_id integer Thrillcall ID of the referenced object
  • updated_at string ISO 8601 representation of last time this object was updated

GET /mappings

Params:

Your API key requires the api_mappings_lookup permission to view mappings outside of your own partner ID.

Returns: Array of Mappings Hash

  // Example: GET /mappings?api_key=1234567890abcdef

  [
    {
      "created_at": "2009-08-13T01:51:23Z",
      "id": 1,
      "obj_type": "artist",
      "partner_display_name": "3",
      "partner_id": "livenation",
      "partner_obj_id": "448380",
      "tc_obj_id": 17498,
      "updated_at": "2012-07-18T00:10:15Z"
    },
    {
      ...
    },
    ...
  ]

GET /mapping/:id

:id integer Thrillcall ID for the Mapping record itself

Your API key requires the api_mappings_lookup permission to view mappings outside of your own partner ID.

Params:

  • None

Returns: Mapping Hash

  // Example: GET /mapping/1?api_key=1234567890abcdef

  {
    "created_at": "2009-08-13T01:51:23Z",
    "id": 1,
    "obj_type": "artist",
    "partner_display_name": "3",
    "partner_id": "livenation",
    "partner_obj_id": "448380",
    "tc_obj_id": 17498,
    "updated_at": "2012-07-18T00:10:15Z"
  }

POST /mapping

Create a new foreign ID mapping

Your API key requires the api_mappings_lookup permission to create mappings outside of your own partner ID.

Params:

  • obj_type integer Type of the referenced object, e.g. "artist"
  • partner_display_name string The name of the object according to the partner, if different
  • partner_id string The name of the partner for this foreign mapping, e.g. "myspace". Requires api_mappings_lookup permission, otherwise defaults to your Partner ID.
  • partner_obj_id string Partner's ID for the referenced object
  • tc_obj_id integer Thrillcall ID of the referenced object

Returns: Mapping Hash

  // Example: POST /mapping?obj_type=artist&partner_id=myspace&partner_obj_id=1&tc_obj_id=2000&api_key=1234567890abcdef

  {
    "created_at": "2009-08-13T01:51:23Z",
    "id": 39821,
    "obj_type": "artist",
    "partner_display_name": null,
    "partner_id": "myspace",
    "partner_obj_id": "1",
    "tc_obj_id": 2000,
    "updated_at": "2012-07-18T00:10:15Z"
  }

PUT /mapping/:id

:id integer Thrillcall ID

Edit an existing foreign ID mapping.

Params:

  • obj_type integer Type of the referenced object, e.g. "artist"
  • partner_display_name string The name of the object according to the partner, if different
  • partner_id string The name of the partner for this foreign mapping, e.g. "myspace". Requires api_mappings_lookup permission, otherwise defaults to your Partner ID.
  • partner_obj_id string Partner's ID for the referenced object
  • tc_obj_id integer Thrillcall ID of the referenced object

Returns: Mapping Hash

  // Example: PUT /mapping/1?partner_obj_id=1000&api_key=1234567890abcdef

  {
    "created_at": "2009-08-13T01:51:23Z",
    "id": 39821,
    "obj_type": "artist",
    "partner_display_name": null,
    "partner_id": "myspace",
    "partner_obj_id": "1000",
    "tc_obj_id": 2000,
    "updated_at": "2012-07-18T00:10:15Z"
  }
Something went wrong with that request. Please try again.