Event Search

get

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

Returns events that match search criteria

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📘
This endpoint is part of Yelp Places API, visit Yelp Places API to learn more.

Query Params

locale

string

Locale code in the format of {language code}_{country code}. See the list of supported locales.

offset

integer

0 to 1000

Offset the list of returned results by this amount.

limit

integer

0 to 50

Defaults to 3

Number of events results to return. By default, it will return 3. Maximum is 50.

sort_by

string

enum

Defaults to desc

Sort by either descending or ascending order.

Allowed:

sort_on

string

enum

Defaults to popularity

Sort on popularity or time start.

Allowed:

start_date

integer

-2208960000 to 221845420800

Unix timestamp. Will return events that only begin at or after the specified time.

end_date

integer

-2208960000 to 221845420800

Unix timestamp. Will return events that only end at or before the specified time.

categories

is_free

boolean

Filter whether the events are free to attend. By default no filter is applied so both free and paid events will be returned.

excluded_events

array of strings

List of event ids. Events associated with these event ids in this list will not show up in the response.

excluded_events

location

string

length between 1 and 250

Required if either latitude or longitude is not provided.
This string indicates the geographic area to be used when searching for events.
Examples: "New York City", "NYC", "350 5th Ave, New York, NY 10118".
Events returned in the response may not be strictly within the specified location.

latitude

number

-90 to 90

Required, if location is not provided. Latitude of the location to search from. If latitude is provided, longitude is required too.

longitude

number

-180 to 180

Required if location is not provided. Longitude of the location to search from. If longitude is provided, latitude is required too.

radius

integer

0 to 40000

Search radius in meters. If the value is too large, a AREA_TOO_LARGE error may be returned. The max value is 40000 meters (about 25 miles).

Responses

code	description
UNAUTHORIZED_API_KEY	The API key provided is not currently able to query this endpoint.
TOKEN_INVALID	Invalid API key or authorization header.

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

📘

200One more more events were found.

400Bad Request. Message varies depending on failure scenario

401The API key has either expired or doesn't have the required scopes to query this endpoint. codedescriptionUNAUTHORIZED_API_KEYThe API key provided is not currently able to query this endpoint.TOKEN_INVALIDInvalid API key or authorization header.

403The API key provided is not currently able to query this endpoint.

404Resource Not Found

413The length of the request exceeded the maximum allowed

429You have either exceeded your daily quota, or have exceeded the queries-per-second limit for this endpoint. Try reducing the rate at which you make queries.

500Internal Server Error

503Service Unavailable