Starting today, Yelp Events data will be available through our Fusion API and GraphQL API to provide rich, local events data in our API as part of our developer beta program. Since launching Yelp Fusion last September, we’ve seen developers use our business data in unique and interesting ways and are excited to see what our developer community will do with the addition of events data.

If you’re not already familiar, Yelp Events is a place where you can create, share and discover upcoming events happening worldwide. Events range from everything from beer festivals to art shows to Shakespeare in the Park.

The Events API will give you access to all of our event listings (current and historical) in the US and internationally (where available) with information on costs, locations, descriptions, associated businesses, venues, and more. You’ll be able to pull events in three different ways:

Searching the Yelp Events database allows you to access a number of different parameters (category, date, time, location, etc.) to see what’s happening near you. This is the easiest way to explore and discover what’s happening in specific locations.

GET https://api.yelp.com/v3/events

{
    "total": 1,
    "events": [
        {
            "attending_count": 4,
            "category": "food-and-drink",
            "description": "Saucy is throwing up a pop-up restaurant party over at Anfilo Coffee! Give the menu a little peruse and then register to reserve your spot! Prices are shown...",
            "event_site_url": "https://www.yelp.com/events/oakland-saucy-oakland-restaurant-pop-up",
            "id": "oakland-saucy-oakland-restaurant-pop-up",
            "interested_count": 9,
            "latitude": 37.8114102,
            "longitude": -122.2665892,
            "name": "Saucy Oakland | Restaurant Pop-Up",
            "tickets_url": "...",
            "time_end": "2017-08-19 04:00",
            "time_start": "2017-08-19 01:00",
            "location": {...},
            "business_id": "anfilo-oakland-2",
            ...,
        }
    ]
}

We also have a group of Community Managers who organize local Yelp events in their areas that we often feature on the Yelp Events page. We’ll be exposing an endpoint to retrieve this data so that you’ll be able to pull the featured event data for any given location.

GET https://api.yelp.com/v3/events/featured

{
  "attending_count": 4,
  "category": "food-and-drink",
  "description": "Saucy is throwing up a pop-up restaurant party over at Anfilo Coffee! Give the menu a little peruse and then register to reserve your spot! Prices are shown...",
  "event_site_url": "https://www.yelp.com/events/oakland-saucy-oakland-restaurant-pop-up",
  "id": "oakland-saucy-oakland-restaurant-pop-up",
  "interested_count": 9,
  "latitude": 37.8114102,
  "longitude": -122.2665892,
  "name": "Saucy Oakland | Restaurant Pop-Up",
  "tickets_url": "...",
  "time_end": "2017-08-19 04:00",
  "time_start": "2017-08-19 01:00",
  "location": {...},
  "business_id": "anfilo-oakland-2",
  ...,
}

Lastly, for cases where you might save event ids for your users, event lookup will allow you to pull information on a specific event to give them quick and easy access to that information.

GET https://api.yelp.com/v3/events/{id}

{
  "attending_count": 4,
  "category": "food-and-drink",
  "description": "Saucy is throwing up a pop-up restaurant party over at Anfilo Coffee! Give the menu a little peruse and then register to reserve your spot! Prices are shown...",
  "event_site_url": "https://www.yelp.com/events/oakland-saucy-oakland-restaurant-pop-up",
  "id": "oakland-saucy-oakland-restaurant-pop-up",
  "interested_count": 9,
  "latitude": 37.8114102,
  "longitude": -122.2665892,
  "name": "Saucy Oakland | Restaurant Pop-Up",
  "tickets_url": "...",
  "time_end": "2017-08-19 04:00",
  "time_start": "2017-08-19 01:00",
  "location": {...},
  "business_id": "anfilo-oakland-2",
  ...,
}

Along with the regular endpoints, this will also be rolling out for GraphQL so that you will also have the ability to load the business data associated with each event, where possible:

{
  events(location: "San Francisco") {
    name
    location
    business {
      name
      url
    }
  }
}

To get started, register for an API key on our developer site and make sure to join our beta program!

Back to blog