This document describes the Thrillcall API v3, and usage for the provided Ruby API wrapper gem.
#---------------------------------------------------------------#
# 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", ...}
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"
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.
-
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.
-
Default: 200
Sets the maximum number of results to return. Cannot be above 200.
-
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.
-
Default: none
If latitude (lat) and longitude (long) if both are specified, results will be within radius of this location.
-
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.
-
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.
-
Default: false
If set to true or 1, will only return results that have tickets associated with them.
-
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.
-
Default: false
If set to true or 1, will not filter out events marked as rumored.
-
Default: false
If set to true , will only return featured events.
-
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.
-
Default: none
If set, will filter Artist results to only those with the specified primary_genre_id
-
Required for creating or updating a Venue.
-
Optional parameter for Venue.
-
Required for creating or updating a Venue.
-
Required for creating or updating a Venue.
-
country_code string (format: "US" length == 2)
Country code, required for Venues.
-
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.
-
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.
-
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.
-
Name of the object from the partner's perspective, optional.
Use to specify a name other than the one supplied in the Thrillcall object.
-
Thrillcall ID for foreign ID mappings.
-
Object type for foreign ID mappings, e.g. "artist"
-
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.
-
The direction you wish to sort the results. Default: DESC
-
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.
- 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
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"
},
{
...
},
...
]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"
}
}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"
}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"
}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
},
{
...
},
...
]Params:
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"
}
]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"
},
{
...
},
...
]- 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)
- 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
},
{
...
},
...
]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
}
}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"
},
{
...
},
...
]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"
}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=]"
},
{
...
},
...
]- 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
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"
},
{
...
},
...
]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"
}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"
},
{
...
},
...
]- 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)
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:
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"
},
{
...
},
...
]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"
}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": {}
},
{
...
},
...
]- 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
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"
},
{
...
},
...
]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"
}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"
}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"
}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
},
{
...
},
...
]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"
},
{
...
},
...
]- 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
- 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"
},
{
...
},
...
]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=]"
}They are used in place of IDs in the following format:
partner_name:obj_type:partner_idFor example:
GET /artist/myspace:artist:alicia_keysFields:
- 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
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"
},
{
...
},
...
]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"
}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"
}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"
}