Back to all discussions

Manager   •   about 15 years ago

API Questions?

You can register for a Lollapalooza API key at http://developers.dostuffmedia.com/get-a-key
API Documentation can be found here: http://developers.dostuffmedia.com/festival-documentation
API Terms of Service is here: http://developers.dostuffmedia.com/api-terms-of-service
If you have questions about the API, please contact: api @ dostuffmedia.com
But you can always feel free to post here at ChallengePost and we'll get you answers. Thanks!

  • 11 comments

  •   •   about 15 years ago

    Can an event ever have more than one band?
    Do keys have a limit of calls they can make a day?

  •   •   about 15 years ago

    Hi Jacob,
    It is possible for an event to have more than one band, yes. There is also a rate limit on API queries, but it's not based on per day, it's based around total number of requests in a span of minutes. If you get a rate limit exceeded, it should allow you to make more calls within a minute or two.
    Hope that helps!

  •   •   about 15 years ago

    Thanks Kirk, few more questions.
    Will the updates call ever return a change of the 'id' feild?
    If there are multiple bands for one event, will bands be in a JSONArray (using '[' ']' annotation) in JSON?
    And in general, how does updates work? When will updates be updated? When will entrys be removed from updates? Does updates also change the referenced entry, or is the update ONLY visable in updates.
    Sorry if these questions are already awnsered in the available documentation, I was unable to find them if they were.

  •   •   about 15 years ago

    The updates call will not return a change of ID unfortunately, but that should be a very rare (if it happens at all) occurrence. Also, if they did, it *would* display the 'new' item in the updates call. So for example, if a band changes ID for some reason, there will be an update that shows the new band API link, but nothing that shows the old one being removed or referenced from the new one. Sorry that's a bit confusing, if it becomes a problem we might need to build something in to show those changes.On the events call, the bands should be in an array, even if there is just one band - on the xml for example, it's event -> bands -> and then multiple band objects. The JSON notation won't be any different than it already is for an event, there will just be multiple band objects inside that bands wrapper.Updates are created anytime a band or event is edited somehow - that could be a change in the description, a change in the time, or anything. They will never be removed from the call, the call will always show a full list of items that were updated starting with the most recent updates.Also, the updates call just tells you what got updated and when, it doesn't actually tell you what changed. It's more of a notice that something on the referenced band or event has changed and you should pull it down with the attached api link and update your local copy of the data.Does that all make sense?

  •   •   about 15 years ago

    Thanks again Kirk!
    And yes, it all makes sense.  I just never worked with a JSONArray with only one value.
    Another question, I assume its an error in the documentation, but can updates take "page" as a parameter? (It doesn't say yes in the documentation, but there are indeed pages).  This is the link I am referencing: http://developers.dostuffmedia.com/festival-documentation/updates-festivals

  •   •   about 15 years ago

    No problem!
    And yes, the updates call should be able to take page as a parameter. The latest changes will always be on page 1, it's sorted to display newest to oldest. I'll see about updating the docs to reflect that, sorry.

  •   •   about 15 years ago

    Alright, this one is going to be a stretch.  But in the above posts we talked about Event with multiple bands, I just looked through the entire 2010 data, and there is not one example.  I was wondering if there was any way would could post example JSON data for an event with multiple bands.  I have some assumptions but I really would like to avoid my code breaking if my assumptions are incorrect.

  •   •   about 15 years ago

    I can't actually change the 2010 data to create a sample, but this is basically what it would look like:
    http://pastebin.com/KAkBhYg1
    It's pretty rare that an event would have multiple bands in this case, but you're right, it's good to be prepared.

  •   •   about 15 years ago

    Did you add new bands to the Lolla 2010 data recently? Specifically duplicate bands entries for Didi Gutman of Brazilian Girls, Empire of the Sun (Full Live Band), FreeSol, F**k Buttons, Matt & Kim, Peanut Butter Wolf, and School of Rock?
    Each of these artists seems to have a newer entry with a much higher ID, an additional set of display_locations data, and no description.
    For example if you check out Matt & Kim, there's a band with the ID 106095 and one with the ID of 49663 and both have a main_lineup_position of 1550. I'm not talking about their additional band entry for their signing, btw.
    And Freesol is 220413 and 40696. School of Rock is 117108 and 73589. And so on.
    Also I couldn't find any event data for the higher IDs of these duplicate bands.
    Thanks.

  •   •   about 15 years ago

    Hi Elenor.
     
    Sometimes our IDs will change b/c there were duplicate entries that were merged.  Sorry for any confustion this may cause.  Let me know if there's anything we can do to help.
     
    thanks!
    scott

  •   •   about 15 years ago

    Any updates on when we should expect to see the 2011 data available?

Comments are closed.