Event Listing Data Normalization

Unify event data from Eventbrite, Ticketmaster, Meetup, Facebook, Songkick, Bandsintown, and 50+ platforms into one canonical event schema. Send payloads or inputs; get normalized events with start/end, location (physical/virtual/hybrid), pricing, provenance, and confidence. Stateless, 25MB max.

原始信息汇总

Event Listing Data Normalization API 数据集概述

数据集名称

Event Listing Data Normalization

数据集描述

该API用于将来自Eventbrite、Ticketmaster、Meetup、Eventful、Facebook、Google、Bandsintown、Songkick、StubHub、SeatGeek等50多个平台的活动列表数据，规范化为一个统一的标准事件模式。通过一次API调用处理单一或混合来源的数据，无需为每个平台单独编写解析器。输出包含统一的时间（ISO格式）、地点（实体、虚拟、混合）、价格、可用性、组织者、图像、来源和置信度信息。

主要功能

• 数据规范化：将任何受支持平台的原始事件数据转换为一致的JSON结构。
• 单一模式：所有事件输出为相同结构，包括ID、标题、描述、开始/结束时间、地点、价格、可用性、组织者、图像、类别、标签、URL、来源和解析信息。
• 混合平台处理：支持在单个请求中处理来自多个平台的数据，返回一个合并的事件数组。单个错误项不会导致整个请求失败。
• 来源与置信度：每个规范化事件包含解析方法和置信度分数，便于过滤或标记低置信度项目。
• 无状态处理：API不存储或记录数据，最大请求负载为25MB，且无需平台API密钥。

关键特性

• 支持50多个平台：包括Eventbrite、Ticketmaster、Meetup、Eventful、Facebook、Google、Bandsintown、Songkick、StubHub、SeatGeek、Eventfinda、YouTube、Twitch等。未知平台使用通用回退处理。
• 地点类型支持：保留实体、虚拟、混合活动的地点类型和虚拟加入URL。
• 标准输出：包含ID、标题、开始/结束时间ISO、地点、价格、可用性、组织者、图像、来源、解析方法、置信度和警告。
• 错误与部分成功：提供逐项错误信息，其他项目仍会被规范化。

使用场景

• 活动聚合与发现：将来自多个平台的活动列表聚合成一个数据集，用于搜索、筛选或日历界面。
• Webhook处理：将来自平台Webhook的事件数据规范化为统一模式，用于同步或显示。
• 数据管道与ETL：在将事件JSON加载到数据仓库或搜索索引之前，进行一步规范化处理。
• 统一活动流：为所有来源提供单一模式，使日历或搜索层能够跨平台工作。

目标用户

• 从多个来源聚合活动的活动聚合器和发现应用开发者。
• 从API、Webhook或数据源摄取事件数据，且不希望维护各供应商解析逻辑的集成商和平台构建者。
• 需要将事件JSON加载到仓库或搜索索引，并希望在加载前进行规范化处理的数据工程师。
• 需要标准事件格式进行显示、提醒或冲突检测的日历和日程安排工具。
• 任何拥有异构事件JSON数据，并需要供应商无关、同构输出以及来源和置信度信息的用户。

端点信息

• 方法: POST
• 路径: /normalize
• 描述: 规范化一个或多个事件数据负载。

请求与响应

请求体必须是JSON，必须包含payload（用于单一供应商）或inputs（用于混合或分桶处理）。

• payload: 原始事件对象或数组。可与可选的platform参数一起使用。
• platform: 平台提示字符串。
• inputs: 输入数组。每个元素是一个{ platform, data: event[] }格式的桶或{ platform?, payload }。

响应包含两个主要字段：

• events: 成功规范化的事件数组（标准模式）。
• errors: 逐项错误数组（包含代码、消息、索引、详情）。

标准事件模式摘要

每个规范化事件具有相同的结构，字段在不可用时为null。

• 核心信息: id, title, description, descriptionPlain, eventType, isVirtual, isHybrid。
• 时间信息: startTime, endTime, startTimeIso, endTimeIso, timezone, durationMinutes。
• 地点信息: location对象，包含type, venueName, address, city, region, country, lat, lng, url, raw。
• 价格与可用性: pricing对象（isFree, minPrice, maxPrice, currency），availability对象（capacity, remaining, isSoldOut, waitlistAvailable）。
• 组织与媒体: organizer对象（name, id, url），images数组。
• 分类与链接: categories, tags字符串数组，url。
• 元数据: provenance对象（platform, sourceRef, parsingStrategy），interpretation对象（method, confidence, warnings）。

支持平台类别

• 票务与现场: eventbrite, ticketmaster, seatgeek, stubhub, universe, ticketweb, frontgate, eventbee, etix, showclix, tickpick, goldstar, axs, dice。
• 社区与本地: meetup, eventful, eventzilla, cvent, nextdoor, allevents, townscript。
• 音乐与表演: bandsintown, songkick, ticketleap, residentadvisor, festivalnet, jambase。
• 体育与竞赛: espn, sportsradar, nrg, raceroster, athlinks。
• 区域/小众: eventfinda, howlround, skiddle, billetto, festicket, eventspot。
• 虚拟/流媒体: zoom, hopin, airmeet, whova, bizzabo, brella, youtube, twitch, vimeo, luma, calendly, webex, microsoft, teams。
• 社交/其他: facebook, google。

未知平台名称将回退到generic_inferred规范化处理。

设计说明与限制

• 无状态: 不存储数据，所有处理在内存中进行。
• 仅输入: API不获取或抓取数据，用户需发送已有的事件负载。
• 部分成功: 返回逐项错误，其他项目仍被规范化。
• 不虚构数据: 缺失的地点、价格或结束时间保持为null，仅设置观测到的数据。
• 最大负载大小: 每个请求25MB。