Please enable JS in your browser for better work of developer.ticketmaster.com

Discovery Feed 2.0

V 1.0

Our v2.0 of Discovery Feed is available. Discovery Feed v1 is deprecated and will be shutdown on August 1st 2018. For details click here .

The Ticketmaster Discovery Feed provides access to event content on Ticketmaster and other ticketing platforms. All data is sourced from the Discovery API and delivered as a separate file per country with multiple formats available.If you are enabled for our affiliate program, all event urls contained in the feed will be updated with affiliate tracking information.

Overview

Authentication

Access is provided to authorized clients only. Please request access by contacting developer@ticketmaster.com. Clients will be provided an API key from Ticketmaster which should be added to every resource endpoint call.

Example: https://app.ticketmaster.com/discovery-feed/v2/events?apikey=GkB8Z6m6fmIfacdQAd6cwPLXj2Oh

Host and API endpoint information

http://app.ticketmaster.com/discovery-feed/v2/

All connections must be made over SSL using https.

Event Sources

The Discovery Feed provides event content from Ticketmaster, FrontGate Tickets and Ticketmaster Resale.

Supported Countries

Events are available from the following countries: US, CA, IE, GB, AU, NZ, MX, AT, BE, DE, DK, ES, FI, NL, NO, PL, SE, CH, CZ and FR.

Options to Get Events Feed

There are two ways of downloading the events feed.

  1. Get feeds in specific formats (csv, xml or json) for a specific country using the country codes mentioned above.
  2. Get the feeds metadata file which contains downloadable uri for feeds for all countries in all the formats : csv, xml and json

1 : Events Feed Per Country [GET]

You can use the direct link to get the event feeds for a particular country in the following formats : csv, xml or json.

https://app.ticketmaster.com/discovery-feed/v2/events.json?apikey={apikey}&countryCode={countryCode}

Parameters

Parameter Description Type Example Required
apikey Your API Key string “GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne” Yes
countryCode The country code of specific the country for which the events feed is required string “US” Yes

Response structure:

Events Feed

Request Response

https://app.ticketmaster.com/discovery-feed/v2/events.json?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne&countryCode=US
Status 200
{
  "eventId" : "G5diZsSggivjL",
  "legacyEventId" : "3B00533D15B0171F",
  "primaryEventUrl" : "http://www.ticketmaster.com/event/3B00533D15B0171F",
  "resaleEventUrl" : null,
  "eventName" : "St. John's v. Molloy",
  "eventInfo" : null,
  "eventNotes" : null,
  "eventStatus" : "onsale",
  "eventImageUrl" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_TABLET_LANDSCAPE_LARGE_16_9.jpg",
  "eventStartDateTime" : "2017-11-20T23:30:00Z",
  "eventStartLocalTime" : "18:30",
  "eventStartLocalDate" : "2017-11-20",
  "eventEndDateTime" : null,
  "venue" : {
    "venueName" : "Carnesecca Arena",
    "venueId" : "KovZpZAEAdFA",
    "legacyVenueId" : "483475",
    "venueUrl" : "http://www.ticketmaster.com/venue/483475",
    "venueTimezone" : "America/New_York",
    "venueZipCode" : "11439",
    "venueLatitude" : 40.72397929,
    "venueLongitude" : -73.79468334,
    "venueStreet" : "8000 Utopia Parkway",
    "venueCity" : "Queens",
    "venueStateCode" : "NY",
    "venueCountryCode" : "US"
  },
  "attractions" : [ {
    "attraction" : {
      "attractionUrl" : "http://www.ticketmaster.com/artist/844662",
      "attractionId" : "K8vZ9171LkV",
      "legacyAttractionId" : "844662",
      "attractionName" : "St. John's Red Storm Men's Basketball",
      "attractionImageUrl" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_TABLET_LANDSCAPE_LARGE_16_9.jpg",
      "images" : [ {
        "image" : {
          "ratio" : "16_9",
          "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_RECOMENDATION_16_9.jpg",
          "width" : 100,
          "height" : 56,
          "fallback" : false
        }
      }, {
        "image" : {
          "ratio" : "16_9",
          "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_RETINA_PORTRAIT_16_9.jpg",
          "width" : 640,
          "height" : 360,
          "fallback" : true
        }
      }, {
        "image" : {
          "ratio" : "16_9",
          "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_RETINA_LANDSCAPE_16_9.jpg",
          "width" : 1136,
          "height" : 639,
          "fallback" : false
        }
      }
      ............
      ,{
        "image" : {
          "ratio" : "3_2",
          "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_TABLET_LANDSCAPE_3_2.jpg",
          "width" : 1024,
          "height" : 683,
          "fallback" : false
        }
      } ]
    "classificationSegmentId" : "KZFzniwnSyZfZ7v7na",
    "classificationSegment" : "Arts & Theatre",
    "classificationGenreId" : "KnvZfZ7v7nl",
    "classificationGenre" : "Fine Art",
    "classificationSubGenreId" : "KZazBEonSMnZfZ7v7ld",
    "classificationSubGenre" : "Fine Art",
    "classificationTypeId" : "KZAyXgnZfZ7v7lt",
    "classificationType" : "Event Style",
    "classificationSubTypeId" : "KZFzBErXgnZfZ7vA6I",
    "classificationSubType" : "Exhibit"
    }
  } ],
  "images" : [ {
    "image" : {
      "ratio" : "16_9",
      "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_RECOMENDATION_16_9.jpg",
      "width" : 100,
      "height" : 56,
      "fallback" : false
    }
  }, {
    "image" : {
      "ratio" : "16_9",
      "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_RETINA_PORTRAIT_16_9.jpg",
      "width" : 640,
      "height" : 360,
      "fallback" : true
    }
  }, {
    "image" : {
      "ratio" : "16_9",
      "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_TABLET_LANDSCAPE_LARGE_16_9.jpg",
      "width" : 2048,
      "height" : 1152,
      "fallback" : false
    }
  }
  .............
  , {
    "image" : {
      "ratio" : "3_2",
      "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_TABLET_LANDSCAPE_3_2.jpg",
      "width" : 1024,
      "height" : 683,
      "fallback" : false
    }
  } ],
  "minPrice" : "25.00",
  "maxPrice" : "35.00",
  "currency" : "USD",
  "onsaleStartDateTime" : "2017-10-09T14:00:00Z",
  "onsaleEndDateTime" : "2017-11-20T23:30:00Z",
  "classificationSegment" : "Sports",
  "classificationGenre" : "Basketball",
  "classificationSubGenre" : "College",
  "presaleName" : null,
  "presaleDateTimeRange" : null,
  "presales" : [ ],
  "source" : "ticketmaster",
  "classificationType" : "Group",
  "classificationSubType" : "Team"
}

2 : Events Feed All Countries [GET]

Get a list of format specific uri to download events for each country.The following formats are available: csv, xml or json per country.

https://app.ticketmaster.com/discovery-feed/v2/events?apikey={apikey}

Parameters

Parameter Description Type Example Required
apikey Your API Key string “GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne” Yes

Response structure:

  • Discovery Feed (array) - Countries
    • {arrayitemobject} - country
      • (array) - formats (csv, json, xml)
        • {arrayitemobject} - format
          • compressed_md5_checksum (string)
          • compressed_size_bytes (string) – compressed size of the zipped file
          • country_code(string) – country code
          • format (string) – format of the events file
          • last_updated (string) - last updated time for the file
          • num_events (string) - no of events in the file
          • uri (string) - path to download the events file

Request Response

https://app.ticketmaster.com/discovery-feed/v2/events?apikey=GkB8Z6m6fmIfacdQAd6cwPLXj2Oh
{
    "countries": {
        "GB": {
            "csv": {
                "compressed_md5_checksum": "81646a7364950775039f694b1ddd6c8a",
                "compressed_size_bytes": 235745605,
                "country_code": "GB",
                "format": "csv",
                "last_updated": "2018-04-04T19:22:12-07:00",
                "num_events": 5710,
                "uri": "https://feeds.ticketmaster.com/public/content/2018-04-03/fd73c66a-03e6-4f05-98ea-3b035f3a12fe/events-GB.csv.gz"
            },
            "json": {
                "compressed_md5_checksum": "fa2fb061a510589bd86340eb68885042",
                "compressed_size_bytes": 23784073201,
                "country_code": "GB",
                "format": "json",
                "last_updated": "2018-04-04T19:22:14-07:00",
                "num_events": 5710,
                "uri": "https://feeds.ticketmaster.com/public/content/2018-04-03/fd73c66a-03e6-4f05-98ea-3b035f3a12fe/events-GB.json.gz"
            },
            "xml": {
                "compressed_md5_checksum": "5a64a261a8633663a83818a266c3d4b5",
                "compressed_size_bytes": 52307300414,
                "country_code": "GB",
                "format": "xml",
                "last_updated": "2018-04-04T19:23:41-07:00",
                "num_events": 5710,
                "uri": "https://feeds.ticketmaster.com/public/content/2018-04-03/fd73c66a-03e6-4f05-98ea-3b035f3a12fe/events-GB.xml.gz"
            }
        },
        "US": {
            "csv": {
                "compressed_md5_checksum": "d4f05dc25e50e2dbc71559141985951a",
                "compressed_size_bytes": 5310932002,
                "country_code": "US",
                "format": "csv",
                "last_updated": "2018-04-04T19:20:30-07:00",
                "num_events": 12005,
                "uri": "https://feeds.ticketmaster.com/public/content/2018-04-03/fd73c66a-03e6-4f05-98ea-3b035f3a12fe/events-US.csv.gz"
            },
            "json": {
                "compressed_md5_checksum": "f4e9c612815ce89e20cbe2ae51069635",
                "compressed_size_bytes": 39574789083,
                "format": "json",
                "last_updated": "2018-04-04T19:21:22-07:00",
                "num_events": 12005,
                "uri": "https://feeds.ticketmaster.com/public/content/2018-04-03/fd73c66a-03e6-4f05-98ea-3b035f3a12fe/events-US.json.gz"
            },
            "xml": {
                "compressed_md5_checksum": "c3fdda22de4b12b33f6aff705b0f2a74",
                "compressed_size_bytes": 73572338891,
                "country_code": "US",
                "format": "xml",
                "last_updated": "2018-04-04T19:22:01-07:00",
                "num_events": 12005,
                "uri": "https://feeds.ticketmaster.com/public/content/2018-04-03/fd73c66a-03e6-4f05-98ea-3b035f3a12fe/events-US.xml.gz"
            }
        }
    }
}

Download event feed file [GET]

Using the specific uri from the response above, the complete details of the events can be downloaded in the following formats : csv, xml or json.The Discovery Feed generates .gz (non-tar) files for the requested format.

https://feeds.ticketmaster.com/public/content/2018-04-03/fd73c66a-03e6-4f05-98ea-3b035f3a12fe/events-GB.csv.gz

Response structure:

Events Feed

Request Response

https://feeds.ticketmaster.com/public/content/2018-04-03/fd73c66a-03e6-4f05-98ea-3b035f3a12fe/events-GB.json.gz
Status 200
{
  "eventId" : "G5diZsSggivjL",
  "legacyEventId" : "3B00533D15B0171F",
  "primaryEventUrl" : "http://www.ticketmaster.com/event/3B00533D15B0171F",
  "resaleEventUrl" : null,
  "eventName" : "St. John's v. Molloy",
  "eventInfo" : null,
  "eventNotes" : null,
  "eventStatus" : "onsale",
  "eventImageUrl" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_TABLET_LANDSCAPE_LARGE_16_9.jpg",
  "eventStartDateTime" : "2017-11-20T23:30:00Z",
  "eventStartLocalTime" : "18:30",
  "eventStartLocalDate" : "2017-11-20",
  "eventEndDateTime" : null,
  "venue" : {
    "venueName" : "Carnesecca Arena",
    "venueId" : "KovZpZAEAdFA",
    "legacyVenueId" : "483475",
    "venueUrl" : "http://www.ticketmaster.com/venue/483475",
    "venueTimezone" : "America/New_York",
    "venueZipCode" : "11439",
    "venueLatitude" : 40.72397929,
    "venueLongitude" : -73.79468334,
    "venueStreet" : "8000 Utopia Parkway",
    "venueCity" : "Queens",
    "venueStateCode" : "NY",
    "venueCountryCode" : "US"
  },
  "attractions" : [ {
    "attraction" : {
      "attractionUrl" : "http://www.ticketmaster.com/artist/844662",
      "attractionId" : "K8vZ9171LkV",
      "legacyAttractionId" : "844662",
      "attractionName" : "St. John's Red Storm Men's Basketball",
      "attractionImageUrl" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_TABLET_LANDSCAPE_LARGE_16_9.jpg",
      "images" : [ {
        "image" : {
          "ratio" : "16_9",
          "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_RECOMENDATION_16_9.jpg",
          "width" : 100,
          "height" : 56,
          "fallback" : false
        }
      }, {
        "image" : {
          "ratio" : "16_9",
          "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_RETINA_PORTRAIT_16_9.jpg",
          "width" : 640,
          "height" : 360,
          "fallback" : true
        }
      }, {
        "image" : {
          "ratio" : "16_9",
          "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_TABLET_LANDSCAPE_LARGE_16_9.jpg",
          "width" : 2048,
          "height" : 1152,
          "fallback" : false
        }
      }, {
        "image" : {
          "ratio" : "4_3",
          "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_CUSTOM.jpg",
          "width" : 305,
          "height" : 225,
          "fallback" : false
        }
      }, {
        "image" : {
          "ratio" : "16_9",
          "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_TABLET_LANDSCAPE_LARGE_16_9.jpg",
          "width" : 2048,
          "height" : 1152,
          "fallback" : true
        }
      }, {
        "image" : {
          "ratio" : "16_9",
          "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_RETINA_PORTRAIT_16_9.jpg",
          "width" : 640,
          "height" : 360,
          "fallback" : false
        }
      }, {
        "image" : {
          "ratio" : "3_2",
          "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_RETINA_PORTRAIT_3_2.jpg",
          "width" : 640,
          "height" : 427,
          "fallback" : false
        }
      }, {
        "image" : {
          "ratio" : "3_2",
          "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_ARTIST_PAGE_3_2.jpg",
          "width" : 305,
          "height" : 203,
          "fallback" : false
        }
      }, {
        "image" : {
          "ratio" : "16_9",
          "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_EVENT_DETAIL_PAGE_16_9.jpg",
          "width" : 205,
          "height" : 115,
          "fallback" : true
        }
      }, {
        "image" : {
          "ratio" : "16_9",
          "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_RETINA_LANDSCAPE_16_9.jpg",
          "width" : 1136,
          "height" : 639,
          "fallback" : true
        }
      }, {
        "image" : {
          "ratio" : "3_2",
          "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_RETINA_PORTRAIT_3_2.jpg",
          "width" : 640,
          "height" : 427,
          "fallback" : true
        }
      }, {
        "image" : {
          "ratio" : "16_9",
          "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_RECOMENDATION_16_9.jpg",
          "width" : 100,
          "height" : 56,
          "fallback" : true
        }
      }, {
        "image" : {
          "ratio" : "3_2",
          "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_TABLET_LANDSCAPE_3_2.jpg",
          "width" : 1024,
          "height" : 683,
          "fallback" : true
        }
      }, {
        "image" : {
          "ratio" : "3_2",
          "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_ARTIST_PAGE_3_2.jpg",
          "width" : 305,
          "height" : 203,
          "fallback" : true
       }
      }, {
        "image" : {
          "ratio" : "16_9",
          "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_TABLET_LANDSCAPE_16_9.jpg",
          "width" : 1024,
          "height" : 576,
          "fallback" : true
        }
      }, {
        "image" : {
          "ratio" : "16_9",
          "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_EVENT_DETAIL_PAGE_16_9.jpg",
          "width" : 205,
          "height" : 115,
          "fallback" : false
        }
      }, {
        "image" : {
          "ratio" : "16_9",
          "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_TABLET_LANDSCAPE_16_9.jpg",
          "width" : 1024,
          "height" : 576,
          "fallback" : false
        }
      }, {
        "image" : {
          "ratio" : "4_3",
          "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_CUSTOM.jpg",
          "width" : 305,
          "height" : 225,
          "fallback" : true
        }
      }, {
        "image" : {
          "ratio" : "16_9",
          "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_RETINA_LANDSCAPE_16_9.jpg",
          "width" : 1136,
          "height" : 639,
          "fallback" : false
        }
      }, {
        "image" : {
          "ratio" : "3_2",
          "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_TABLET_LANDSCAPE_3_2.jpg",
          "width" : 1024,
          "height" : 683,
          "fallback" : false
        }
      } ]
    "classificationSegmentId" : "KZFzniwnSyZfZ7v7na",
    "classificationSegment" : "Arts & Theatre",
    "classificationGenreId" : "KnvZfZ7v7nl",
    "classificationGenre" : "Fine Art",
    "classificationSubGenreId" : "KZazBEonSMnZfZ7v7ld",
    "classificationSubGenre" : "Fine Art",
    "classificationTypeId" : "KZAyXgnZfZ7v7lt",
    "classificationType" : "Event Style",
    "classificationSubTypeId" : "KZFzBErXgnZfZ7vA6I",
    "classificationSubType" : "Exhibit"
    }
  } ],
  "images" : [ {
    "image" : {
      "ratio" : "16_9",
      "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_RECOMENDATION_16_9.jpg",
      "width" : 100,
      "height" : 56,
      "fallback" : false
    }
  }, {
    "image" : {
      "ratio" : "16_9",
      "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_RETINA_PORTRAIT_16_9.jpg",
      "width" : 640,
      "height" : 360,
      "fallback" : true
    }
  }, {
    "image" : {
      "ratio" : "16_9",
      "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_TABLET_LANDSCAPE_LARGE_16_9.jpg",
      "width" : 2048,
      "height" : 1152,
      "fallback" : false
    }
  }, {
    "image" : {
      "ratio" : "4_3",
      "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_CUSTOM.jpg",
      "width" : 305,
      "height" : 225,
      "fallback" : false
    }
  }, {
    "image" : {
      "ratio" : "16_9",
      "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_TABLET_LANDSCAPE_LARGE_16_9.jpg",
      "width" : 2048,
      "height" : 1152,
      "fallback" : true
    }
  }, {
    "image" : {
      "ratio" : "16_9",
      "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_RETINA_PORTRAIT_16_9.jpg",
      "width" : 640,
      "height" : 360,
      "fallback" : false
    }
  }, {
    "image" : {
      "ratio" : "3_2",
      "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_RETINA_PORTRAIT_3_2.jpg",
      "width" : 640,
      "height" : 427,
      "fallback" : false
    }
  }, {
    "image" : {
      "ratio" : "3_2",
      "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_ARTIST_PAGE_3_2.jpg",
      "width" : 305,
      "height" : 203,
      "fallback" : false
    }
  }, {
    "image" : {
      "ratio" : "16_9",
      "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_EVENT_DETAIL_PAGE_16_9.jpg",
      "width" : 205,
      "height" : 115,
      "fallback" : true
    }
  }, {
    "image" : {
      "ratio" : "16_9",
      "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_RETINA_LANDSCAPE_16_9.jpg",
      "width" : 1136,
      "height" : 639,
      "fallback" : true
    }
  }, {
    "image" : {
      "ratio" : "16_9",
      "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_RECOMENDATION_16_9.jpg",
      "width" : 100,
      "height" : 56,
      "fallback" : true
    }
  }, {
    "image" : {
      "ratio" : "3_2",
      "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_RETINA_PORTRAIT_3_2.jpg",
      "width" : 640,
      "height" : 427,
      "fallback" : true
    }
  }, {
    "image" : {
      "ratio" : "3_2",
      "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_TABLET_LANDSCAPE_3_2.jpg",
      "width" : 1024,
      "height" : 683,
      "fallback" : true
    }
  }, {
    "image" : {
      "ratio" : "3_2",
      "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_ARTIST_PAGE_3_2.jpg",
      "width" : 305,
      "height" : 203,
      "fallback" : true
    }
  }, {
    "image" : {
      "ratio" : "16_9",
      "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_TABLET_LANDSCAPE_16_9.jpg",
      "width" : 1024,
      "height" : 576,
      "fallback" : true
    }
  }, {
    "image" : {
      "ratio" : "16_9",
      "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_EVENT_DETAIL_PAGE_16_9.jpg",
      "width" : 205,
      "height" : 115,
      "fallback" : false
    }
  }, {
    "image" : {
      "ratio" : "16_9",
      "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_TABLET_LANDSCAPE_16_9.jpg",
      "width" : 1024,
      "height" : 576,
      "fallback" : false
    }
  }, {
    "image" : {
      "ratio" : "4_3",
      "url" : "https://s1.ticketm.net/dam/c/8d5/f95bdd17-1d94-4e98-9295-641e4db558d5_105621_CUSTOM.jpg",
      "width" : 305,
      "height" : 225,
      "fallback" : true
    }
  }, {
    "image" : {
      "ratio" : "16_9",
      "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_RETINA_LANDSCAPE_16_9.jpg",
      "width" : 1136,
      "height" : 639,
      "fallback" : false
    }
  }, {
    "image" : {
      "ratio" : "3_2",
      "url" : "https://s1.ticketm.net/dam/a/ace/4173edef-6e4b-4677-8b45-d4fde6549ace_48141_TABLET_LANDSCAPE_3_2.jpg",
      "width" : 1024,
      "height" : 683,
      "fallback" : false
    }
  } ],
  "minPrice" : "25.00",
  "maxPrice" : "35.00",
  "currency" : "USD",
  "onsaleStartDateTime" : "2017-10-09T14:00:00Z",
  "onsaleEndDateTime" : "2017-11-20T23:30:00Z",
  "classificationSegment" : "Sports",
  "classificationGenre" : "Basketball",
  "classificationSubGenre" : "College",
  "presaleName" : null,
  "presaleDateTimeRange" : null,
  "presales" : [ ],
  "source" : "ticketmaster",
  "classificationType" : "Group",
  "classificationSubType" : "Team"
}

Events Feed

  • Discovery Feed Events (array) - Events .
    • {arrayitemobject} - event
      • eventId (string) - Unique ID for the event
      • legacyEventId (string) – unique ID of the event (old format)
      • primaryEventUrl(string) – URL of the event detail page
      • resaleEventUrl (string) – URL to buy resale tickets for the event
      • eventName (string) - Name of the event
      • eventNotes (string) - Notes for the event
      • eventStatus (string) - Status of the event
      • eventImageUrl (string) – Public URL of the event image
      • eventInfo (string) - Event Information
      • eventStartDateTime (string) – Event start date/time (UTC format)
      • eventEndDateTime (string) – Event end date/time (UTC format)
      • eventStartLocalDate (string) – Event date in the venue’s timezone MM/DD/YY format
      • eventStartLocalTime (string) – Event start time in the venue’s timezone HH:MM format
      • promoters (array) - Promoters
        • {arrayitemobject} - Promoter
          • id (string)
          • name (string)
          • description (string)
      • venue (object) - Venue
        • venueName (string) – Name of the venue
        • legacyVenueId (string) – unique ID of the venue (old format)
        • venueId (string) – Unique ID of the venue
        • venueStreet (string) – Address of the venue
        • venueCity (string) – City of the venue
        • venueStateCode (string) – State/Province of the venue
        • venueCountryCode (string) – Country of the venue
        • venueLatitude (string) – Latitude of the venue
        • venueLongitude (string) – Longitude of the venue
        • venueZipCode (string) – Postal code/zipcode of the venue
        • venueTimezone (string) – Timezone of the venue
        • venueUrl (string) – URL of the venue detail page
      • attractions (array) - Attractions
        • {arrayitemobject} - Attraction
          • attractionUrl (string) – URL of the attraction detail page
          • attractionName (string) – list of attraction names
          • legacyAttractionId (string) – unique ID of the attraction (old format)
          • attractionId (string) – list of unique attraction IDs
          • attractionImageUrl (string) – list of attraction image URLs
          • classificationSegmentId(string) - Segment Id
          • classificationSegment(string) - A Segment is a primary genre for an attraction
          • classificationGenreId(string) - Genre Id
          • classificationGenre(string) - Secondary Genre to further describe an attraction
          • classificationSubGenreId(string) - Sub Genre Id
          • classificationSubGenre(string) - Tertiary Genre for additional detail when describing an attraction
          • classificationTypeId(string) - Classification Type Id
          • classificationType(string) - A Type represents a kind of attraction
          • classificationSubTypeId(string) - Classification Sub Type Id
          • classificationSubType (string) - Secondary Type to further categorize an attraction
          • images (array) - Images
            • {arrayitemobject} - Image
              • ratio (string)
              • url (string)
              • width (string)
              • height (string)
              • fallback (string)
      • minPrice (string) – Minimum price
      • maxPrice (string) – Maximum price
      • currency (string) – Currency
      • onsaleStartDateTime (string) – Event onsale start date/time UTC format
      • onsaleEndDateTime (string) – Event onsale end date/time UTC format
      • classificationSegment (string) - A Segment is a primary genre for an entity Music, Sports, Arts, etc)
      • classificationGenre (string) - Secondary Genre to further describe an entity (Rock, Classical, Animation, etc)
      • classificationSubGenre (string) - Tertiary Genre for additional detail when describing an entity (Alternative Rock,Ambient Pop, etc)
      • presaleName (string) – Name of the presale
      • presaleDateTimeRange (string) – Description of the presale
      • presales (object) - Presales
        • presaleName (string) – list of presale names
        • presaleDescription (string) – list of presale descriptions
        • presaleStartDateTime (string) – list of presale start/date times (UTC format)
        • presaleEndDateTime (string) – list of presale end/date times (UTC format)
      • source (string) – source ticketing platform of event
      • classificationType (string) - A Type represents a kind or group of people. (Donation, Group, Individual, Merchandise, Event Style, etc)
      • classificationSubType (string) - Secondary Type to further categorize an entity (Band, Choir, Chorus, etc)

FAQs

When it will be ready?

Discovery Feed v2 was released on May 1, 2018.

How it will work?

Data files will be published to an external CDN. You will be able to request the list of available files and meta data from a new API endpoint located at: https://app.ticketmaster.com/discovery-feed/v2/events. The meta data on each file includes the country code, file path, file format, compressed md5 checksum, compressed file size, number of events, and last updated timestamp. Below is sample request and response:

Sample request: https://app.ticketmaster.com/discovery-feed/v2/events?apikey=GkB8Z6m6fmIfacdQAd6cwPLXj2Oh

Sample response: Feed Metadata Response .

What else is changing?

Nothing. You can still expect:

  • To choose between .json, .xml and .csv file formats.
  • To download compressed versions (.gz) of each data file.
  • The same event content and response structure for each data file.
  • Files to auto-populate your affiliate tracking links if you are signed up as an affiliate.
  • Hourly updates of the content.
  • To find the documentation for the Discovery Feed on the Ticketmaster Developer Portal.

What you need to do?

Migrate to Discovery Feed v2 by July 31st. On Aug 1st, we will be sunsetting Discovery Feed v1, and you will no longer be able to retrieve files from the old service: https://app.ticketmaster.com/dc/feeds/v1.

Until then, we will have limited support for v1 and address issues on a case-by-case basis, so we encourage you to upgrade to v2 as soon as you can.

How you can test?

You can test against the new production API service when it’s released in production.

Where to send questions?

You can continue to send us questions at partnersupport@ticketmaster.com.