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

Parameters
Artists
- GET /artists
- POST /artist
- GET /artist/:id
- PUT /artist/:id
- GET /artist/:id/events
- GET /artist/:id/genres
- 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
Venues
- GET /venues
- POST /venue
- GET /venue/:id
- PUT /venue/:id
- GET /venue/:id/events
- GET /search/venues/:term
Tickets
- GET /tickets
- GET /ticket/:id
Mappings
- GET /mappings
- GET /mapping/:id
- POST /mapping
- PUT /mapping/:id

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.
ids string

Default: nil

Comma-separated list of ID integers, like "100,200,300".

If provided to a list endpoint (e.g. /venues), will retrieve only the specific venue ids listed.
limit integer

Default: 200

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.
long float

Default: none

If latitude (lat) and longitude (long) if both are specified, results will be within radius of this location.
postalcode string (format: length >= 5)

Default: none

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

For POST / PUT requests: Optional for creating or updating a Venue.
radius float

Default: 100.0

Used in conjunction with lat/long or postalcode
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.
featured_events_only boolean

Default: false

If set to true , will only return featured events.
with_discover boolean

Default: false

If set to true in recommended_events endpoint, the list of events will include events from artists similar to the user's tracked artists.
primary_genre_id integer

Default: none

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

Required for creating or updating a Venue.
address2 string

Optional parameter for Venue.
city string

Required for creating or updating a Venue.
state string

Required for creating or updating a Venue.
country_code string (format: "US" length == 2)

Country code, required for Venues.
name string

Name of the Artist or Venue.
facebook_url string (format: "http://facebook.com/ladygaga")

Facebook URL for the Artist or Venue.
myspace_url string (format: "http://myspace.com/ladygaga")

Myspace URL for the Artist.
official_url string (format: "http://www.ladygaga.com/")

Official URL for the Artist or Venue.
wikipedia_url string (format: "http://en.wikipedia.org/wiki/Lady_Gaga")

Wikipedia URL for the Artist.
youtube_url string (format: "http://www.youtube.com/user/ladygagaofficial")

YouTube URL for the Artist.
artist_names string

A list of comma separated artist names.
mappings string or array (format: ["myspace", "livenation"])

Foreign ID mappings for the specified partners, if available, will be provided along with the object data.

Can be provided as a single param ("mappings=myspace") or as an array ("mappings[]=myspace&mappings[]=livenation").

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

Name of the partner for foreign ID mappings, e.g. "myspace"

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

Foreign ID for mappings, can be a string or integer.
partner_display_name string

Name of the object from the partner's perspective, optional.

Use to specify a name other than the one supplied in the Thrillcall object.
tc_obj_id integer

Thrillcall ID for foreign ID mappings.
obj_type string

Object type for foreign ID mappings, e.g. "artist"
sort string

The name of the field you wish to sort by, e.g. "created_at".

When searching by radius, or from the Metro Area endpoint, you can also specify "distance," although this value is not directly exposed.

Calls for Artists, Genres, Tickets, Venues, and all Search endpoints default to using the "name" field.

Calls for Events default to the "starts_at" field.

Calls for Metro Areas default to the "city" field.

Calls for Mappings default to the "partner_id" field.
order string: "ASC" or "DESC"

The direction you wish to sort the results. Default: DESC
polling_for string

Comma-separated list of services to poll. Use this to decrease response time if recommendations from only one or two services need to be refreshed.

e.g. "spotify,lastfm"

If specified, will only return recommended artists from these services. Popular artists will be omitted.

If not specified, will return recommended artists from all available services, as well as popular artists.

## 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:

ids
limit
page
primary_genre_id
mappings
sort
order

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:

name
facebook_url
myspace_url
official_url
wikipedia_url
youtube_url

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](#content_mappings)**

Params:

mappings

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](#content_mappings)**

Params:

name
facebook_url
myspace_url
official_url
wikipedia_url
youtube_url
mappings

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](#content_mappings)**

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
featured_events_only
mappings
sort
order

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 /artist/:id/events **:id** _integer_ Thrillcall or **[Mapping](#content_mappings)**

Params:

category

Returns: Array of Genres Hash

    // Example: GET /api/v3/artist/378465/genres?api_key=1234567890abcdef&category=main

    [
      {
        "id": 18,
        "name": "Pop",
        "created_at": "2008-07-09T19:17:45Z",
        "updated_at": "2010-03-25T23:52:08Z",
        "description": "Lady GaGa, Justin Bieber etc...",
        "category": "main"
      },
      {
        "id": 27,
        "name": "Rock",
        "created_at": "2008-07-09T19:17:45Z",
        "updated_at": "2010-03-25T23:52:21Z",
        "description": "U2, 30 Seconds To Mars etc...",
        "category": "main"
      },
      {
        "id": 134,
        "name": "Electronic",
        "created_at": "2009-05-28T06:47:25Z",
        "updated_at": "2010-03-25T23:54:43Z",
        "description": "Hot Chip, Passion Pit etc...",
        "category": "main"
      },
      {
        "id": 137,
        "name": "Dance",
        "created_at": "2009-05-28T06:54:18Z",
        "updated_at": "2010-03-25T23:55:20Z",
        "description": "Daft Punk, Deadmau5 etc...",
        "category": "main"
      },
      {
        "id": 338,
        "name": "dance pop",
        "created_at": "2015-05-15T20:17:48Z",
        "updated_at": "2015-05-15T20:17:48Z",
        "description": null,
        "category": "subgenre"
      }
    ]

### GET /search/artists/:term **:term** _string_ Arbitrary search string on the **name** field. (alphanumerics only, underscore matches underscore, use '+' for space)

Params:

limit
page
mappings
sort
order

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:

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
featured_events_only
sort
order

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:

limit
page
mappings
sort
order

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:

mappings

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:

limit
page
ticket_type
sort
order

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:

limit
page
sort
order

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
mappings
sort
order

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:

ids
limit
page
sort
order

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

Params:

lat
long
radius
limit
page
sort
order

Returns: Array of Metro Areas Hash

    // Example: GET /api/v3/metro_areas?&api_key=1234567890abcdef&&lat=37.7833&long=-122.4167&radius=50`

    [
      {
        "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:

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
featured_events_only
mappings
sort
order

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

## 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:

ids
limit
page
lat
long
postalcode
radius
mappings
sort
order

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:

name
address1
address2
city
state
postalcode
country_code
facebook_url
official_url

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](#content_mappings)**

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:

name
address1
address2
city
state
postalcode
country_code
facebook_url
official_url

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](#content_mappings)**

Params:

limit
page
time_zone
min_date
max_date
min_updated_at
max_updated_at
ticket_type
must_have_tickets
show_disabled_events
show_unconfirmed_events
show_rumor_events
featured_events_only
sort
order

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:

limit
page
lat
long
postalcode
radius
sort
order

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:

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
sort
order

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:

sort
order
mappings

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"
  }

thrillcall-api

Development

Runtime

Thrillcall API

Ruby API Wrapper

Usage:

Advanced Usage:

HTTPS Endpoints

Contents

SSL/TLS Endpoints Required: