{
  "openapi": "3.1.0",
  "info": {
    "title": "Events API",
    "version": "1.0.0",
    "summary": "Tech, data and AI conferences worldwide, with dates, city, host company, topics and the official site, curated from organizers’ own pages",
    "description": "Tech, data and AI conferences worldwide, with dates, city, host company, topics and the official site, curated from organizers’ own pages. Refreshed every night at 07:30 UTC. Free to read; please cite \"Events (events.fru.dev)\" with a link. Responses are cached at the edge; keep to about 60 requests a minute. Guide: https://events.fru.dev/agents",
    "contact": {
      "name": "fru.dev",
      "url": "https://fru.dev",
      "email": "fru.dev3@gmail.com"
    }
  },
  "externalDocs": {
    "description": "For AI agents",
    "url": "https://events.fru.dev/agents"
  },
  "servers": [
    {
      "url": "https://events.fru.dev"
    }
  ],
  "paths": {
    "/api/conferences": {
      "get": {
        "operationId": "list_conferences",
        "summary": "Conferences in date order, upcoming by default",
        "description": "Conferences in date order, upcoming by default. Returns conferences with dates, city, country, format, host, topics, official site and an Events link.",
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "Ends on or after this day, YYYY-MM-DD (default today)",
            "schema": {
              "type": "string"
            },
            "example": "2026-10-01"
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "description": "Starts on or before this day, YYYY-MM-DD",
            "schema": {
              "type": "string"
            },
            "example": "2026-12-31"
          },
          {
            "name": "host",
            "in": "query",
            "required": false,
            "description": "Host key, e.g. snowflake, databricks, google",
            "schema": {
              "type": "string"
            },
            "example": "snowflake"
          },
          {
            "name": "place",
            "in": "query",
            "required": false,
            "description": "Place key, e.g. minnesota, sf-bay-area, london",
            "schema": {
              "type": "string"
            },
            "example": "minnesota"
          },
          {
            "name": "topic",
            "in": "query",
            "required": false,
            "description": "Topic, e.g. AI, Data, Cloud, Security",
            "schema": {
              "type": "string"
            },
            "example": "AI"
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Words that must all appear (name, host, city, topic)",
            "schema": {
              "type": "string"
            },
            "example": "summit"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Items per page, 1 to 200",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 200
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip, for the next page",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "conferences with dates, city, country, format, host, topics, official site and an Events link",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "from": "2026-09-24",
                  "to": null,
                  "total": 175,
                  "limit": 3,
                  "offset": 0,
                  "next": "/api/conferences?topic=AI&limit=3&offset=3",
                  "conferences": [
                    {
                      "id": "oktane-2026",
                      "name": "Oktane 2026",
                      "series": "Oktane",
                      "start": "2026-09-22",
                      "end": "2026-09-24",
                      "datesTentative": false,
                      "format": "hybrid",
                      "venue": "Caesars Forum",
                      "city": "Las Vegas",
                      "region": "NV",
                      "country": "United States",
                      "place": {
                        "key": "las-vegas",
                        "name": "Las Vegas"
                      },
                      "where": "Las Vegas, NV",
                      "host": {
                        "key": "okta",
                        "name": "Okta"
                      }
                    },
                    {
                      "id": "ai-engineer-paris-2026",
                      "name": "AI Engineer Paris 2026",
                      "series": "AI Engineer Paris",
                      "start": "2026-09-23",
                      "end": "2026-09-24",
                      "datesTentative": false,
                      "format": "in-person",
                      "venue": "Station F",
                      "city": "Paris",
                      "region": "Ile-de-France",
                      "country": "France",
                      "place": {
                        "key": "paris",
                        "name": "Paris"
                      },
                      "where": "Paris, France",
                      "host": {
                        "key": "ai-engineer",
                        "name": "AI Engineer"
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/conferences/{id}": {
      "get": {
        "operationId": "get_conference",
        "summary": "One conference, with the other editions of its series",
        "description": "One conference, with the other editions of its series. Returns the conference and its other editions, newest first.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Conference id from list_conferences",
            "schema": {
              "type": "string"
            },
            "example": "snowflake-summit-2027"
          }
        ],
        "responses": {
          "200": {
            "description": "the conference and its other editions, newest first",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "conference": {
                    "id": "snowflake-summit-2027",
                    "name": "Snowflake Summit 2027",
                    "series": "Snowflake Summit",
                    "start": "2027-06-07",
                    "end": "2027-06-10",
                    "datesTentative": false,
                    "format": "in-person",
                    "venue": "Moscone Center",
                    "city": "San Francisco",
                    "region": "CA",
                    "country": "United States",
                    "place": {
                      "key": "sf-bay-area",
                      "name": "SF Bay Area"
                    },
                    "where": "San Francisco, SF Bay Area, CA",
                    "host": {
                      "key": "snowflake",
                      "name": "Snowflake"
                    }
                  },
                  "editions": [
                    {
                      "id": "snowflake-summit-2026",
                      "name": "Snowflake Summit 2026",
                      "series": "Snowflake Summit",
                      "start": "2026-06-01",
                      "end": "2026-06-04",
                      "datesTentative": false,
                      "format": "in-person",
                      "venue": "Moscone Center",
                      "city": "San Francisco",
                      "region": "CA",
                      "country": "United States",
                      "place": {
                        "key": "sf-bay-area",
                        "name": "SF Bay Area"
                      },
                      "where": "San Francisco, SF Bay Area, CA",
                      "host": {
                        "key": "snowflake",
                        "name": "Snowflake"
                      }
                    },
                    {
                      "id": "snowflake-summit-2025",
                      "name": "Snowflake Summit 2025",
                      "series": "Snowflake Summit",
                      "start": "2025-06-02",
                      "end": "2025-06-05",
                      "datesTentative": false,
                      "format": "in-person",
                      "venue": "San Francisco",
                      "city": "",
                      "region": "",
                      "country": "United States",
                      "place": {
                        "key": "tba",
                        "name": "Location TBA"
                      },
                      "where": "Location TBA",
                      "host": {
                        "key": "snowflake",
                        "name": "Snowflake"
                      }
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "description": "Not found"
          }
        }
      }
    },
    "/api/hosts": {
      "get": {
        "operationId": "list_hosts",
        "summary": "Every company or organizer with a conference on file",
        "description": "Every company or organizer with a conference on file. Returns hosts with upcoming and total counts and the next conference.",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Items per page, 1 to 200",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 200
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip, for the next page",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "hosts with upcoming and total counts and the next conference",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "total": 391,
                  "limit": 3,
                  "offset": 0,
                  "next": "/api/hosts?limit=3&offset=3",
                  "hosts": [
                    {
                      "key": "databricks",
                      "name": "Databricks",
                      "upcoming": 18,
                      "total": 23,
                      "next": {
                        "id": "data-ai-world-tour-mumbai-2026",
                        "name": "Data + AI World Tour Mumbai 2026",
                        "series": "Data + AI World Tour",
                        "start": "2026-10-07",
                        "end": "2026-10-07",
                        "datesTentative": false,
                        "format": "in-person",
                        "venue": "",
                        "city": "Mumbai",
                        "region": "Maharashtra",
                        "country": "India",
                        "place": {
                          "key": "mumbai",
                          "name": "Mumbai"
                        },
                        "where": "Mumbai, India",
                        "host": {
                          "key": "databricks",
                          "name": "Databricks"
                        }
                      },
                      "link": "https://events.fru.dev/hosts/databricks"
                    },
                    {
                      "key": "linux-foundation",
                      "name": "Linux Foundation",
                      "upcoming": 14,
                      "total": 22,
                      "next": {
                        "id": "mcp-dev-summit-toronto-2026",
                        "name": "MCP Dev Summit Toronto 2026",
                        "series": "MCP Dev Summit",
                        "start": "2026-10-05",
                        "end": "2026-10-06",
                        "datesTentative": false,
                        "format": "in-person",
                        "venue": "",
                        "city": "Toronto",
                        "region": "Ontario",
                        "country": "Canada",
                        "place": {
                          "key": "toronto",
                          "name": "Toronto"
                        },
                        "where": "Toronto, Canada",
                        "host": {
                          "key": "linux-foundation",
                          "name": "Linux Foundation"
                        }
                      },
                      "link": "https://events.fru.dev/hosts/linux-foundation"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/search": {
      "get": {
        "operationId": "search",
        "summary": "Search conferences, hosts and places",
        "description": "Search conferences, hosts and places. Returns up to 20 ranked results with title, link and one line.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Conference, company or city",
            "schema": {
              "type": "string"
            },
            "example": "databricks"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Results, 1 to 20",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 20,
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "up to 20 ranked results with title, link and one line",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "q": "databricks",
                  "results": [
                    {
                      "id": "host:databricks",
                      "group": "companies",
                      "title": "Databricks",
                      "subtitle": "18 upcoming · next Data + AI World Tour",
                      "href": "/hosts/databricks",
                      "keywords": [
                        "databricks",
                        "databricks.com"
                      ],
                      "logo": "https://img.logo.dev/databricks.com?token=...&retina=true&format=png&theme=light&fallback=404",
                      "boost": 15,
                      "score": 1065
                    },
                    {
                      "id": "ev:data-ai-summit-2027",
                      "group": "items",
                      "title": "Data + AI Summit 2027",
                      "subtitle": "Jun 21, 2027 · San Francisco, SF Bay Area, CA",
                      "href": "/events/data-ai-summit-2027",
                      "keywords": [
                        "Data + AI Summit",
                        "Databricks"
                      ],
                      "logo": "https://img.logo.dev/databricks.com?token=...&retina=true&format=png&theme=light&fallback=404",
                      "boost": 20,
                      "score": 995
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
  }
}