WeekSpots

Semantic search over upcoming events in Paris and Île-de-France. The query can be in any language and describe a need ("rainy day activity for a 4 year old", "jazz gratuit", "亲子手工"). Returns up to 10 events, best match first, nearest first when a location is given.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What the user is looking for, in natural language.",
      "maxLength": 200
    },
    "lang": {
      "type": "string",
      "enum": [
        "fr",
        "en",
        "zh"
      ],
      "description": "Language of titles and summaries. Default: en."
    },
    "near_lat": {
      "type": "number",
      "description": "Latitude to search around (optional, with near_lon)."
    },
    "near_lon": {
      "type": "number",
      "description": "Longitude to search around (optional, with near_lat)."
    },
    "radius_km": {
      "type": "number",
      "enum": [
        2,
        3,
        5,
        8,
        12,
        20,
        30,
        50
      ],
      "description": "Only with near_lat/near_lon: keep events within this distance."
    },
    "date_from": {
      "type": "string",
      "description": "Earliest day, YYYY-MM-DD (Europe/Paris). Optional."
    },
    "date_to": {
      "type": "string",
      "description": "Latest day, YYYY-MM-DD (Europe/Paris), inclusive. Optional."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Number of events, default 8."
    }
  },
  "required": [
    "query"
  ]
}

Upcoming events in one town of Île-de-France (e.g. Paris, Versailles, Saint-Germain-en-Laye), soonest first. Optional filter: this weekend, free, or for children. Returns up to 10 events and the total count; `more_url` is the full list.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "Town name, e.g. \"Versailles\".",
      "maxLength": 80
    },
    "filter": {
      "type": "string",
      "enum": [
        "weekend",
        "free",
        "kids"
      ],
      "description": "weekend = this weekend, free = free admission, kids = for children. Optional."
    },
    "lang": {
      "type": "string",
      "enum": [
        "fr",
        "en",
        "zh"
      ],
      "description": "Language of titles and summaries. Default: en."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Number of events, default 8."
    }
  },
  "required": [
    "city"
  ]
}

Details of one event by the `id` returned by search_events or list_city_events: dates, venue, price and age information, booking link, conditions.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Event id, e.g. \"qfap:123102\".",
      "maxLength": 200
    },
    "lang": {
      "type": "string",
      "enum": [
        "fr",
        "en",
        "zh"
      ],
      "description": "Language of titles and summaries. Default: en."
    }
  },
  "required": [
    "id"
  ]
}

Permanent places open all year anywhere in France (playgrounds, parks, sports courts, skateparks, pools, amusement parks, zoos, libraries, museums and other cultural venues, heritage sites), nearest first. Use it when there is no dated event that fits, or the user wants a place rather than an event. Give a location (near_lat/near_lon) or a town of Île-de-France. Returns up to 10 places.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "playground",
        "park",
        "courts",
        "skate",
        "pool",
        "fun",
        "zoo",
        "library",
        "culture",
        "heritage"
      ],
      "description": "Kind of place. Optional: all kinds when omitted."
    },
    "near_lat": {
      "type": "number",
      "description": "Latitude to search around (with near_lon)."
    },
    "near_lon": {
      "type": "number",
      "description": "Longitude to search around (with near_lat)."
    },
    "city": {
      "type": "string",
      "description": "Town in Île-de-France, used when no coordinates are given, e.g. \"Versailles\".",
      "maxLength": 80
    },
    "radius_km": {
      "type": "number",
      "enum": [
        1,
        2,
        3,
        5,
        10
      ],
      "description": "Search radius, default 3."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Number of places, default 8."
    }
  }
}