Sign in

v11

latestOpenAPI 3.1.12026-08-03174162.0 MB
Events

Suggest event genres and categories

Uses AI to analyze event description and optional artwork to suggest relevant music genres and event categories. Returns up to 5 genres and 10 categories with a confidence score.

post/events/tags

Request body

eventIdstring

Event ID for rate limiting and change detection. If provided, suggestions are limited to once per day per event and only if the description changed significantly.

descriptionstring required

Event description to analyze for genre and category suggestions. Minimum 100 characters required for meaningful AI analysis.

eventNamestring

Optional event name for additional context

imageUrlstring uri

Optional event artwork URL for visual analysis (multimodal)

Example request

{
  "eventId": "evt_01jps5cgsenjrazw6wswmyspa3",
  "description": "Join us for an all-night warehouse party featuring the best in tech house and melodic techno. BYO drinks, intimate vibes, and a killer sound system.",
  "eventName": "Warehouse Sessions Vol. 5",
  "imageUrl": "https://assets.session.services/events/poster.jpg"
}

Response

OK

genresstring[] required

Suggested music genres based on event description and artwork

categoriesstring[] required

Suggested event categories based on description and artwork

confidencenumber required

AI confidence score for the suggestions (0-1)

startDatestring

Event start date/time. Either ISO 8601 format (if specific date found) or natural language hint for relative dates (e.g., 'next Saturday 9pm').

endDatestring

Event end date/time. Either ISO 8601 format (if specific date found) or natural language hint.

venueNamestring

Venue or location name extracted from the description or artwork. Used to search for and prefill the event location.

ticketUrlstring uri

External ticket purchase URL if found in the description. Only extracted if different from the host platform.

Example response

{
  "genres": [
    "Tech House",
    "Melodic Techno"
  ],
  "categories": [
    "Warehouse",
    "Underground",
    "BYO"
  ],
  "confidence": 0.85,
  "startDate": "2025-02-15T21:00:00",
  "endDate": "2025-02-16T04:00:00",
  "venueName": "Warehouse 21",
  "ticketUrl": "https://www.eventbrite.com/e/warehouse-sessions-tickets-123"
}