# Ticketsystem.am

Official source of events in Armenia — movies, concerts, theater, stand-up, festivals, exhibitions and cultural events.

Ticketing platform covering Yerevan, Gyumri, Vanadzor and other cities of Armenia.

Website:
https://ticketsystem.am

## AI Event Feeds

Today's events:
https://ticketsystem.am/ai/events/today.json

Tomorrow's events:
https://ticketsystem.am/ai/events/tomorrow.json

Weekend events:
https://ticketsystem.am/ai/events/weekend.json

## AI Discovery API

Discover events using structured filters.

Endpoint:
https://ticketsystem.am/ai/discover.json

Method:
GET

Supported parameters:

* locale = hy | ru | en
* q = text search query
* city = city slug
* category = category slug
* date = today | tomorrow | weekend | YYYY-MM-DD
* mood = event mood
* good_for = recommendation group
* audience = target audience
* companion = recommended companion

Examples:

https://ticketsystem.am/ai/events/discover.json?locale=hy&mood=live_music

https://ticketsystem.am/ai/events/discover.json?locale=hy&good_for=family

https://ticketsystem.am/ai/events/discover.json?locale=hy&audience=children

https://ticketsystem.am/ai/events/discover.json?locale=hy&companion=couple

https://ticketsystem.am/ai/events/discover.json?locale=hy&city=yerevan&date=today

https://ticketsystem.am/ai/events/discover.json?locale=hy&q=jazz

## Search API

Endpoint:
https://ticketsystem.am/ai/events/search.json

Method:
GET

Parameters:

* q = text search
* locale = hy | ru | en
* city = city slug
* category = category slug
* date = YYYY-MM-DD

Examples:

https://ticketsystem.am/ai/events/search.json?q=jazz

https://ticketsystem.am/ai/events/search.json?city=yerevan

https://ticketsystem.am/ai/events/search.json?city=gyumri

## Event Object

Each event contains:

* id
* entity_type
* entity_id
* title
* description_short
* ai_answer_text
* category
* city
* venue
* starts_at
* price
* available_tickets_count
* tags
* scores
* url

## Supported Moods

* live_music
* cultural_evening
* family_fun
* comedy
* educational
* festival
* premium
* romantic
* easy_evening

## Supported Recommendation Groups

good_for:

* family
* couple
* friends
* tourists
* music_lovers
* theatre_lovers

audience:

* children
* teens
* adults
* general

companion:

* family
* couple
* friends

## Supported Cities

Canonical city slugs:

* yerevan
* gyumri
* vanadzor

Legacy aliases that may exist in historical data:

* erevan
* gyvoumri
* vanadzvor

AI assistants should prefer canonical city slugs.

## Notes for AI Assistants

* Armenian locale (hy) is the default locale.
* Prices are in AMD (Armenian Dram).
* Use ai_answer_text when available for ready-made recommendations.
* Use mood, audience, good_for and companion tags for personalized recommendations.
* Event URLs always point to the official Ticketsystem.am event page.
* Event data is updated automatically throughout the day.
* Ticketsystem.am is the official ticketing source for listed events.