biseyvarmi.com – Etkinlik Rehberi

Covers events in Türkiye (Turkey) only. Searches current listings on biseyvarmi.com, which gathers events across Turkish ticket providers: what is on, where and when (etkinlik, ne var, konser, tiyatro, stand-up, sergi, festival, çocuk, opera, bale, atölye), in a city or district such as İstanbul, Kadıköy, Beşiktaş, Ankara or İzmir, with dates, venues and prices. Requires at least one of city, category or q. Each result includes its biseyvarmi.com event page link (a short bise.ws link), where dates, prices and ticket options are confirmed. At most 20 results, no paging; a district, category, dates or words give more specific results. A refused question returns the reason.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "A Turkish city by name, e.g. \"istanbul\", \"ankara\", \"izmir\", \"mugla\"; a well-known district (\"bodrum\", \"kadikoy\") also works."
    },
    "district": {
      "type": "string",
      "description": "A district of the city, e.g. \"kadikoy\"; needs city."
    },
    "category": {
      "type": "string",
      "enum": [
        "tiyatro",
        "muzik",
        "standup",
        "opera",
        "bale-ve-dans",
        "performans",
        "sergi-muze-ve-fuar",
        "film",
        "cocuk-ve-aile",
        "festival",
        "spor",
        "dinleti-ve-konferans",
        "egitim-ve-atolye",
        "yeme-ve-icme",
        "oyun-ve-yarisma",
        "saglik-ve-yasam",
        "sosyal-etkinlik-ve-tur",
        "diger"
      ],
      "description": "One category slug."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day, YYYY-MM-DD (Istanbul time). Default today."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day, YYYY-MM-DD. Default from + 30 days; a wider span is cut to 92 days."
    },
    "q": {
      "type": "string",
      "maxLength": 80,
      "description": "Search words in Turkish or English: a title, performer or venue. Alternatives are separated by commas (at most four)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Results to return, default 10."
    }
  },
  "additionalProperties": false
}

Covers events in Türkiye (Turkey) only. Searches current listings on biseyvarmi.com from a plain question in Turkish or English, e.g. "Kadıköy'de bu hafta sonu konser", "tiyatro Ankara yarın", "Hamlet İstanbul", "kids events in Beşiktaş this weekend". Reads the place (city or district), the kind of event (konser, tiyatro, stand-up, sergi, festival, çocuk…) and the time (bugün, yarın, bu hafta sonu); the rest is searched as a title, performer or venue. Returns up to 10 events with ids; an id can be passed to fetch for dates, venues and prices.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "The question, in Turkish or English."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "url"
        ]
      }
    }
  },
  "required": [
    "results"
  ]
}

Full details of one event found with search: upcoming dates and times (Istanbul), venues, price range, category and credits, with the biseyvarmi.com link where tickets are confirmed.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}$",
      "description": "An id from search results."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    }
  },
  "required": [
    "id",
    "title",
    "text",
    "url"
  ]
}