> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anysite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# /yolo/events/search

> List Yolo events in Tbilisi and Batumi (Georgia). Filter by category, city, service language, price range, date (relative preset or explicit range) and order by price. Optionally narrow by a free-text keyword matched against event titles. Each event has title, category, image, date range, venue, from-price and currency, external ticket url and source.

**Price:** 1 credit

**💡 AI Hint:** List Yolo (Tbilisi/Batumi, Georgia) events. Set count to how many you want. Filter by category (e.g. theater, musical, festivals), city (tbilisi/batumi), language (en/ka/ko/ru/fr), price_min/price_max (GEL), date (today/this-week/this-month) or an explicit date_from/date_to range, and sort (cheaper/expensive). keyword narrows by event title. Each item has id, alias, title, category, image, start_at/end_at (YYYY-MM-DD), venue, price (from-price), currency, ticket_url and source_url.



## OpenAPI

````yaml /openapi/events-tickets.json post /api/yolo/events/search
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/yolo/events/search:
    post:
      tags:
        - /yolo
      summary: /yolo/events/search
      description: >-
        List Yolo events in Tbilisi and Batumi (Georgia). Filter by category,
        city, service language, price range, date (relative preset or explicit
        range) and order by price. Optionally narrow by a free-text keyword
        matched against event titles. Each event has title, category, image,
        date range, venue, from-price and currency, external ticket url and
        source.


        **Price:** 1 credit


        **💡 AI Hint:** List Yolo (Tbilisi/Batumi, Georgia) events. Set count to
        how many you want. Filter by category (e.g. theater, musical,
        festivals), city (tbilisi/batumi), language (en/ka/ko/ru/fr),
        price_min/price_max (GEL), date (today/this-week/this-month) or an
        explicit date_from/date_to range, and sort (cheaper/expensive). keyword
        narrows by event title. Each item has id, alias, title, category, image,
        start_at/end_at (YYYY-MM-DD), venue, price (from-price), currency,
        ticket_url and source_url.
      operationId: __api_yolo_events_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/YoloEventsSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/YoloEvent'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    YoloEventsSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          description: Max scrapping execution timeout (in seconds)
          default: 300
        keyword:
          anyOf:
            - type: string
              minLength: 1
            - type: 'null'
          description: Free-text query matched against event titles
        category:
          anyOf:
            - $ref: '#/components/schemas/YoloCategory'
            - type: 'null'
          description: Restrict to a single event category
        city:
          anyOf:
            - $ref: '#/components/schemas/YoloCity'
            - type: 'null'
          description: Restrict to a city
        language:
          anyOf:
            - $ref: '#/components/schemas/YoloLanguage'
            - type: 'null'
          description: Restrict to the event service language
        price_min:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
          description: Minimum ticket price in GEL
        price_max:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
          description: Maximum ticket price in GEL
        date:
          anyOf:
            - $ref: '#/components/schemas/YoloDatePreset'
            - type: 'null'
          description: Restrict to a relative date range
        date_from:
          anyOf:
            - type: string
            - type: 'null'
          description: Start of an explicit date range (YYYY-MM-DD or DD.MM.YYYY)
        date_to:
          anyOf:
            - type: string
            - type: 'null'
          description: End of an explicit date range (YYYY-MM-DD or DD.MM.YYYY)
        sort:
          anyOf:
            - $ref: '#/components/schemas/YoloSort'
            - type: 'null'
          description: Order results by price
        count:
          type: integer
          minimum: 1
          description: Max number of events to return
      type: object
      required:
        - count
    YoloEvent:
      properties:
        '@type':
          type: string
          default: YoloEvent
        id:
          anyOf:
            - type: string
            - type: 'null'
        alias:
          anyOf:
            - type: string
            - type: 'null'
        category:
          anyOf:
            - type: string
            - type: 'null'
        description:
          anyOf:
            - type: string
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        images:
          items:
            type: string
          type: array
          default: []
        price:
          anyOf:
            - type: number
            - type: 'null'
        currency:
          anyOf:
            - type: string
            - type: 'null'
        service_languages:
          items:
            type: string
          type: array
          default: []
        start_at:
          anyOf:
            - type: string
            - type: 'null'
        end_at:
          anyOf:
            - type: string
            - type: 'null'
        city:
          anyOf:
            - type: string
            - type: 'null'
        country:
          anyOf:
            - type: string
            - type: 'null'
          default: Georgia
        venue:
          anyOf:
            - type: string
            - type: 'null'
        address:
          anyOf:
            - type: string
            - type: 'null'
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - type: 'null'
        location_url:
          anyOf:
            - type: string
            - type: 'null'
        location_alias:
          anyOf:
            - type: string
            - type: 'null'
        ticket_url:
          anyOf:
            - type: string
            - type: 'null'
        source_url:
          anyOf:
            - type: string
            - type: 'null'
        sessions:
          items:
            $ref: '#/components/schemas/YoloEventSession'
          type: array
          default: []
        lang:
          type: string
          default: ru
      type: object
      required:
        - title
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    YoloCategory:
      type: string
      enum:
        - musical
        - gastronomic
        - theater
        - cafe
        - festivals
        - tourism
        - exhibition
        - kids
        - education
        - nightlife
        - sports
        - others
        - movies
        - spiritual
        - new-year
        - valentines-day
        - womens-day
        - mothers-day
    YoloCity:
      type: string
      enum:
        - tbilisi
        - batumi
    YoloLanguage:
      type: string
      enum:
        - en
        - ka
        - ko
        - ru
        - fr
    YoloDatePreset:
      type: string
      enum:
        - today
        - this-week
        - this-month
    YoloSort:
      type: string
      enum:
        - cheaper
        - expensive
    YoloEventSession:
      properties:
        '@type':
          type: string
          default: YoloEventSession
        date:
          anyOf:
            - type: string
            - type: 'null'
        weekday:
          anyOf:
            - type: string
            - type: 'null'
        time:
          anyOf:
            - type: string
            - type: 'null'
        price_min:
          anyOf:
            - type: number
            - type: 'null'
        price_max:
          anyOf:
            - type: number
            - type: 'null'
        currency:
          anyOf:
            - type: string
            - type: 'null'
        buy_url:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````