feverup.com APIfeverup.com ↗
Access Feverup event listings, categories, venues, ratings, and pricing across cities worldwide via 6 structured API endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/e12557d2-bcfd-4498-a035-9341769b02b4/list_cities' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the list of suggested and top cities supported by Fever. No parameters required. Returns city codes, names, slugs, and whether they are top cities.
No input parameters required.
{
"type": "object",
"fields": {
"cities": "array of city objects with city_id, city_code, city_name, country_name, slug, thumbnail_url, and is_top_city"
},
"sample": {
"data": {
"cities": [
{
"slug": "new-york",
"city_id": 6,
"city_code": "NYC",
"city_name": "New York",
"is_top_city": true,
"country_name": "United States",
"thumbnail_url": "https://applications-media.feverup.com/image/upload/fever2/city/photos/web/new-york-560x560.jpg"
}
]
},
"status": "success"
}
}About the feverup.com API
The Feverup API exposes 6 endpoints that return event and experience data from Feverup.com, covering city discovery, keyword search, category filtering, and full event details. The get_event_detail endpoint returns a complete record including venue address, image gallery, ticket price, category, and ISO-formatted end date. City coverage is available through list_cities, which returns city codes used as filter parameters across every other endpoint.
City Discovery and Event Search
The list_cities endpoint requires no parameters and returns an array of city objects, each with a city_code, city_name, country_name, slug, thumbnail_url, and an is_top_city boolean. The city_code values (e.g. NYC, LON, PAR) are the input parameter used by search_events, get_city_events, get_category_events, and get_exhibition_expos to scope results geographically.
search_events accepts a required query string and an optional city_code, returning paginated results with total_count, a next_page cursor (integer or null), and an array of event objects carrying fields like rating, num_ratings, price, currency, location_name, and cover_image_url. The same paginated response shape is shared across get_city_events, get_category_events, and get_exhibition_expos.
Category and Specialized Filtering
get_category_events filters by a category slug such as candlelight-concerts, exhibitions, or immersive-experiences, combined with an optional city_code. get_exhibition_expos is a purpose-built endpoint that surfaces gallery shows, art fairs, and expo-style events without requiring a category or query parameter — only an optional city_code and page.
Event Detail
get_event_detail takes a numeric plan_id sourced from any listing endpoint and returns the full event record: title, url, price, currency, category, rating, end_date (ISO datetime), an images array of URLs, and a structured venue object containing name, address, city, region, and country. This is the only endpoint that exposes the full venue address and multi-image array.
- Build a city events calendar by pulling
get_city_eventsresults for a targetcity_codeand displayingname,price, andcover_image_url. - Power a concert discovery feed using
get_category_eventswith thecandlelight-concertscategory slug filtered by city. - Aggregate exhibition and art fair listings across multiple cities using
get_exhibition_exposwith differentcity_codevalues. - Enrich event records with full venue addresses and image galleries by calling
get_event_detailwithplan_idvalues from search results. - Compare ticket prices and ratings across events in a given city by iterating paginated
search_eventsresults and extractingprice,currency, andratingfields. - Populate a destination guide app with top-city metadata from
list_citiesusing theis_top_cityflag andthumbnail_url.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Feverup have an official public developer API?+
What does `get_event_detail` return that listing endpoints do not?+
get_event_detail is the only endpoint that returns a structured venue object with a full address, region, and country, a multi-image images array, and an end_date ISO datetime. Listing endpoints return a subset: cover_image_url, location_name, price, rating, and city_code, but no full address or event end time.How does pagination work across the listing endpoints?+
search_events, get_city_events, get_category_events, get_exhibition_expos) return a next_page integer in the response. When there are no further pages, next_page is null. Pass the returned integer as the page parameter on the next request. Omitting page always returns the first page.Does the API return session times or schedule slots for individual events?+
end_date at the event level via get_event_detail and aggregate event metadata across listing endpoints, but individual session times and availability slots are not returned. You can fork this API on Parse and revise it to add an endpoint targeting per-session schedule data.Are all Feverup cities available, or only a subset?+
list_cities endpoint returns the cities Fever actively surfaces, including both standard and top-tier cities flagged by is_top_city. Cities not present in that list cannot be used as city_code filter values in other endpoints. Coverage reflects what Feverup indexes for a given city at the time of the request.