Events listed on AllEvents for a city, optionally in one category, with name, start and end, venue with address and coordinates, online or in person, image and ticket offers. Narrow to today, tomorrow or this weekend with date, or to a keyword with q (neither combines with category or with the other). Pass next_page back as page (null on the last page).
Every response includes credits_used: the credits this call cost.
Parameters
name
type
description
cityrequired
string
City as in allevents.in/<city> (new-york, london, mumbai, toronto, sydney ...). Example: new-york
category
string
Category as in allevents.in/<city>/<category> (all by default): music, concerts, nightlife, parties, comedy, theatre, art, festivals, food-drinks, business, workshops, sports, health-wellness, kids ...; see categories in the response.
page
integer
Page number (1 by default).
date
today | tomorrow | weekend
Only events today, tomorrow or this weekend (the site's own date lists). Not with category or q.
q
string
Keyword, e.g. jazz, halloween, food festival (the site's keyword lists for the city; 60 characters at most). Not with category or date; for a category name use category.
import os, requests
res = requests.get(
"https://api.api.sh/allevents/v1/events",
params={"city": "new-york"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json()
const url = new URL("https://api.api.sh/allevents/v1/events");
url.searchParams.set("city", "new-york");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();
Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.