Skip to main content
POST
/
api
/
yolo
/
events
/
search
/yolo/events/search
curl --request POST \
  --url https://api.anysite.io/api/yolo/events/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "keyword": "<string>",
  "price_min": 1,
  "price_max": 1,
  "date_from": "<string>",
  "date_to": "<string>"
}
'
[
  {
    "@type": "YoloEvent",
    "id": "<string>",
    "alias": "<string>",
    "category": "<string>",
    "description": "<string>",
    "image": "<string>",
    "images": [],
    "price": 123,
    "currency": "<string>",
    "service_languages": [],
    "start_at": "<string>",
    "end_at": "<string>",
    "city": "<string>",
    "country": "Georgia",
    "venue": "<string>",
    "address": "<string>",
    "latitude": 123,
    "longitude": 123,
    "location_url": "<string>",
    "location_alias": "<string>",
    "ticket_url": "<string>",
    "source_url": "<string>",
    "sessions": [],
    "lang": "ru"
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required

Max number of events to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
keyword
string | null

Free-text query matched against event titles

Minimum string length: 1
category
enum<string> | null

Restrict to a single event category

Available options:
musical,
gastronomic,
theater,
cafe,
festivals,
tourism,
exhibition,
kids,
education,
nightlife,
sports,
others,
movies,
spiritual,
new-year,
valentines-day,
womens-day,
mothers-day
city
enum<string> | null

Restrict to a city

Available options:
tbilisi,
batumi
language
enum<string> | null

Restrict to the event service language

Available options:
en,
ka,
ko,
ru,
fr
price_min
number | null

Minimum ticket price in GEL

Required range: x >= 0
price_max
number | null

Maximum ticket price in GEL

Required range: x >= 0
date
enum<string> | null

Restrict to a relative date range

Available options:
today,
this-week,
this-month
date_from
string | null

Start of an explicit date range (YYYY-MM-DD or DD.MM.YYYY)

date_to
string | null

End of an explicit date range (YYYY-MM-DD or DD.MM.YYYY)

sort
enum<string> | null

Order results by price

Available options:
cheaper,
expensive

Response

Successful Response

@type
string
default:YoloEvent
id
string | null
alias
string | null
category
string | null
description
string | null
image
string | null
images
string[]
price
number | null
currency
string | null
service_languages
string[]
start_at
string | null
end_at
string | null
city
string | null
country
string | null
default:Georgia
venue
string | null
address
string | null
latitude
number | null
longitude
number | null
location_url
string | null
location_alias
string | null
ticket_url
string | null
source_url
string | null
sessions
object[]
lang
string
default:ru