{
  "openapi": "3.0.1",
  "info": {
    "title": "Find Events",
    "description": "Queries multiple event platforms for a given city and category, returning a single normalized dataset of scheduled events. Supported platforms include Eventbrite, Meetup, Luma, Dice, Eventnoire, Posh, Prekindle, and Shotgun.",
    "version": "0.0",
    "x-build-id": "j8dsQlkFMOQcX6iy4"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/hypebridge~find-events/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-hypebridge-find-events",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/hypebridge~find-events/runs": {
      "post": {
        "operationId": "runs-sync-hypebridge-find-events",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/hypebridge~find-events/run-sync": {
      "post": {
        "operationId": "run-sync-hypebridge-find-events",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "category",
          "city",
          "maxEvents"
        ],
        "properties": {
          "category": {
            "title": "Category",
            "enum": [
              "all",
              "music",
              "nightlife",
              "business",
              "technology",
              "food_drink",
              "arts_culture",
              "comedy",
              "sports_fitness",
              "wellness",
              "community_culture",
              "family_education"
            ],
            "type": "string",
            "description": "Canonical event category used to route across supported platforms.",
            "default": "all"
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "Free-form city, optionally including state or country, for example Dallas, TX or New York.",
            "default": "Dallas, TX"
          },
          "timeWindow": {
            "title": "Time window",
            "enum": [
              "this_week",
              "this_month",
              "all"
            ],
            "type": "string",
            "description": "Filter events to a simple time window. Resolved to concrete start/end dates internally using the resolved city timezone.",
            "default": "this_month"
          },
          "maxEvents": {
            "title": "Max events",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Maximum number of normalized events to return across all platforms.",
            "default": 50
          },
          "getEventDetails": {
            "title": "Get event details",
            "type": "boolean",
            "description": "Ask supported child actors to enrich listings with full event-page details. Unsupported child actors ignore this setting.",
            "default": false
          },
          "platforms": {
            "title": "Platforms",
            "uniqueItems": true,
            "type": "array",
            "description": "Optional source allowlist. Leave empty for Auto, which considers every locally applicable source and orders them by local affinity. Choose values only to restrict the search.",
            "items": {
              "type": "string",
              "enum": [
                "eventbrite",
                "meetup",
                "luma",
                "partiful",
                "dice",
                "eventnoire",
                "posh",
                "prekindle",
                "shotgun",
                "showpass",
                "sympla",
                "runsignup",
                "eventeny",
                "ra",
                "xceed",
                "fever"
              ],
              "enumTitles": [
                "Eventbrite",
                "Meetup",
                "Luma",
                "Partiful",
                "Dice",
                "Eventnoire",
                "Posh",
                "Prekindle",
                "Shotgun",
                "Showpass",
                "Sympla",
                "RunSignup",
                "Eventeny",
                "Resident Advisor",
                "Xceed",
                "Fever"
              ]
            },
            "default": []
          },
          "childRunTimeoutSecs": {
            "title": "Child run timeout",
            "minimum": 30,
            "maximum": 900,
            "type": "integer",
            "description": "Maximum seconds to wait for any one downstream actor.",
            "default": 240
          },
          "debugMode": {
            "title": "Debug mode",
            "type": "boolean",
            "description": "Store route plans, child inputs, affinity decisions, and skipped-platform reasons in the key-value store.",
            "default": false
          },
          "conferenceName": {
            "title": "Conference name",
            "type": "string",
            "description": "Return only events that belong to this conference, such as its side events and official parties. Each event's title and description is matched to the conference with an LLM. Leave empty for a normal city search."
          },
          "conferenceContext": {
            "title": "Extra context",
            "type": "string",
            "description": "Optional hints for matching: the official hashtag, venue, website, or other names the conference goes by."
          },
          "conferenceStartDate": {
            "title": "Conference start date",
            "type": "string",
            "description": "First day to search (YYYY-MM-DD). Use with the end date to cover the conference week. Overrides the time window. Posh (and Eventbrite, when selected) only search the current month, so they are skipped when these dates fall outside it."
          },
          "conferenceEndDate": {
            "title": "Conference end date",
            "type": "string",
            "description": "Last day to search (YYYY-MM-DD)."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}