Investigate eventful API capabilities and data structure

[finne132]

http://api.eventful.com/json/categories/list?app_key=pz73k49VfxrJv6Mf

returns a list of possible "categories" for event search. Here they are:

{
  "category": [
    {
      "name": "Concerts & Tour Dates",
      "event_count": null,
      "id": "music"
    },
    {
      "name": "Conferences & Tradeshows",
      "event_count": null,
      "id": "conference"
    },
    {
      "name": "Comedy",
      "event_count": null,
      "id": "comedy"
    },
    {
      "name": "Education",
      "event_count": null,
      "id": "learning_education"
    },
    {
      "name": "Kids & Family",
      "event_count": null,
      "id": "family_fun_kids"
    },
    {
      "name": "Festivals",
      "event_count": null,
      "id": "festivals_parades"
    },
    {
      "name": "Film",
      "event_count": null,
      "id": "movies_film"
    },
    {
      "name": "Food & Wine",
      "event_count": null,
      "id": "food"
    },
    {
      "name": "Fundraising & Charity",
      "event_count": null,
      "id": "fundraisers"
    },
    {
      "name": "Art Galleries & Exhibits",
      "event_count": null,
      "id": "art"
    },
    {
      "name": "Health & Wellness",
      "event_count": null,
      "id": "support"
    },
    {
      "name": "Holiday",
      "event_count": null,
      "id": "holiday"
    },
    {
      "name": "Literary & Books",
      "event_count": null,
      "id": "books"
    },
    {
      "name": "Museums & Attractions",
      "event_count": null,
      "id": "attractions"
    },
    {
      "name": "Neighborhood",
      "event_count": null,
      "id": "community"
    },
    {
      "name": "Business & Networking",
      "event_count": null,
      "id": "business"
    },
    {
      "name": "Nightlife & Singles",
      "event_count": null,
      "id": "singles_social"
    },
    {
      "name": "University & Alumni",
      "event_count": null,
      "id": "schools_alumni"
    },
    {
      "name": "Organizations & Meetups",
      "event_count": null,
      "id": "clubs_associations"
    },
    {
      "name": "Outdoors & Recreation",
      "event_count": null,
      "id": "outdoors_recreation"
    },
    {
      "name": "Performing Arts",
      "event_count": null,
      "id": "performing_arts"
    },
    {
      "name": "Pets",
      "event_count": null,
      "id": "animals"
    },
    {
      "name": "Politics & Activism",
      "event_count": null,
      "id": "politics_activism"
    },
    {
      "name": "Sales & Retail",
      "event_count": null,
      "id": "sales"
    },
    {
      "name": "Science",
      "event_count": null,
      "id": "science"
    },
    {
      "name": "Religion & Spirituality",
      "event_count": null,
      "id": "religion_spirituality"
    },
    {
      "name": "Sports",
      "event_count": null,
      "id": "sports"
    },
    {
      "name": "Technology",
      "event_count": null,
      "id": "technology"
    },
    {
      "name": "Other & Miscellaneous",
      "event_count": null,
      "id": "other"
    }
  ]
}

[finne132]

within: integer If within is set and the "location" parameter resolves to a specific geolocation, the search will be restricted to the specified radius. If the "location" parameter does not resolve to a specific location, this parameter is ignored. (optional)

[finne132]

location: string A location name to use in filtering the search results. Locations in the form "San Diego", "San Diego, TX", "London, United Kingdom", and "Calgary, Alberta, Canada" are accepted, as are postal codes ("92122") and venue IDs ("V0-001-000268633-5"). Common geocoordinate formats ("32.746682, -117.162741") are also accepted, but the "within" parameter is required in order to set a search radius. (optional)

[finne132]

date: string Limit this list of results to a date range, specified by label or exact range. Currently supported labels include: "All", "Future", "Past", "Today", "Last Week", "This Week", "Next week", and months by name, e.g. "October". Exact ranges can be specified the form 'YYYYMMDD00-YYYYMMDD00', for example '2012042500-2012042700'; the last two digits of each date in this format are ignored. (optional)

[finne132]

units: string One of "mi" or "km", the units of the "within" parameter. Defaults to "mi".(optional)

[finne132]

sort_order: string One of 'popularity', 'date', or 'relevance'. Default is 'relevance'. (optional)

mature: string Sets the level of filtering for events marked as "mature" due to keywords in the title or description. One of 'all' (no filtering), 'normal', or 'safe'. 'Normal' mature filtering consists of words that are clearly profanities and inappropriate for younger audiences. 'Safe' mature filtering consists of all normal mature filtered words, as well as other terms that may be used as inappropriate innuendo. A 'safe' filter may eliminate events that are benign in nature, but contain questionable content based on keywords. Defaults to 'all'. (optional)