Skip to main content
POST
/
api
/
expato
/
events
/
search
/expato/events/search
curl --request POST \
  --url https://api.anysite.io/api/expato/events/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "keyword": "<string>",
  "city": [],
  "category": [],
  "language": [],
  "status": [],
  "venue": "<string>",
  "organizer": "<string>",
  "promo_available": true,
  "sort": "default"
}
'
[
  {
    "@type": "ExpatoEvent",
    "id": "<string>",
    "alias": "<string>",
    "source_url": "<string>",
    "image": "<string>",
    "images": [],
    "ticket_url": "<string>",
    "price": 123,
    "currency": "<string>",
    "start_at": 123,
    "display_until_at": 123,
    "city": "<string>",
    "venue": "<string>",
    "hall": "<string>",
    "language": "<string>",
    "categories": [],
    "description": "<string>",
    "promo_code": "<string>",
    "has_promo": false,
    "status": "<string>",
    "is_active": false,
    "organizer": "<string>",
    "organizer_url": "<string>",
    "country": "Netherlands",
    "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 search across event text fields (title, description, location and more)

city
enum<string>[] | null

Filter by one or more cities

Available options:
Алкмаар,
Амстердам,
Гаага,
Гронинген,
Делфт,
Зандам,
Зволле,
Лейден,
Маастрихт,
Наймеген,
Рейсвейк,
Роттердам,
Тилбург,
Утрехт,
Харлем,
Хертогенбос,
Хофддорп,
Эйндховен
category
enum<string>[] | null

Filter by one or more categories

Available options:
Благотворительность,
Для детей,
Искусство,
История,
Кино,
Лекции,
Литература,
Музыка,
Образование,
Политика,
Презентация книги,
Спектакли,
Творческая встреча,
Фестиваль,
Юмор
language
enum<string>[] | null

Filter by one or more event languages

Available options:
Английский,
Английский (с русскими субтитрами),
Белорусский,
Грузинский,
Иврит (с английскими субтитрами),
Нидерландский,
Русский,
Украинский,
Французский
status
enum<string>[] | null

Filter by event status (active / past)

Available options:
Активные,
Прошедшие
venue
string | null

Filter by venue name or address (substring match)

organizer
string | null

Filter by organizer name (substring match)

promo_available
boolean | null

Keep only events that have a promo code

sort
enum<string>
default:default

Result ordering

Available options:
default,
date_asc,
date_desc

Response

Successful Response

@type
string
default:ExpatoEvent
id
string | null
alias
string | null
source_url
string | null
image
string | null
images
string[]
ticket_url
string | null
price
number | null
currency
string | null
start_at
integer | null
display_until_at
integer | null
city
string | null
venue
string | null
hall
string | null
language
string | null
categories
string[]
description
string | null
promo_code
string | null
has_promo
boolean
default:false
status
string | null
is_active
boolean
default:false
organizer
string | null
organizer_url
string | null
country
string
default:Netherlands
lang
string
default:ru