latestOpenAPI 3.1.02026-07-248941352.6 KB

d3f744f55ed7

Events

Featured Event

This endpoint returns the featured event for a given location. Featured events are chosen by Yelp's community managers.

get/v3/events/featured

Parameters

#/paths/~1v3~1events/get/parameters/10 — unresolved $ref
#/paths/~1v3~1events/get/parameters/11 — unresolved $ref
#/paths/~1v3~1events/get/parameters/12 — unresolved $ref
#/paths/~1v3~1events/get/parameters/0 — unresolved $ref

Response

A featured event was returned.

idstring required

Unique ID of the event.

namestring nullable

Name of the event.

descriptionstring nullable

Description excerpt of this event.

business_idstring nullable

Yelp Business ID of this event. No ID is returned if a business is not associated with an event.

categorystring nullable

The category of the event.

costnumber nullable

Cost of attending the event.

cost_maxnumber nullable

Maximum cost of attending the event.

event_site_urlstring nullable

Yelp page of the event.

image_urlstring nullable

Yelp image URL of the event.

tickets_urlstring nullable

URL to buy tickets for the event.

attending_countinteger

Number of Yelp users attending the event.

interested_countinteger

Number of Yelp users interested in attending the event.

is_canceledboolean

Whether the event is canceled.

is_freeboolean

Whether the event is free.

is_officialboolean

Whether the event is created by a Yelp community manager.

latitudenumber float nullable

Latitude of the event location.

longitudenumber float nullable

Longitude of the event location.

time_startstring required

Time the event starts. Returns date and time in ISO 8601 format.

time_endstring nullable

Time the event ends. Returns date and time in ISO 8601 format.