本地事件评分提供一个 API,允许其他公司将我们的事件智能直接集成到他们自己的平台中,因此他们的用户可以在不离开仪表板的情况下查看即将到来的本地事件 + 预测的交通影响。
他们无需从头构建事件发现、分类、评分和过滤,而是简单地使用商店地址(或邮政编码)调用我们的 API,我们会返回一个包含影响评分及支持元数据的结构化事件列表。
当仪表板发送请求(例如:“显示我附近的事件”)时,API 返回:
附近即将发生的事件
事件详情(名称、日期、类型、描述)
影响评分(影响人流的可能性)
影响原因(为什么会有这样的评分)
可选过滤方式:
角色(个人、家庭、旅行者等)
兴趣(音乐、食物、运动等)
日期范围
事件与地点模式
语言(英语 / 西班牙语)
商业模式影响评分(零售为主)
一旦集成,合作伙伴可以在他们自己的用户界面中显示本地事件评分,比如:
1) 地点“事件影响”小部件
一个显示本月前五个可能影响交通的事件的卡片,带有评分徽章(高/中/低)。
2) 日历 + 导出体验
事件填充日历视图,并可以导出、保存或添加到旅行计划中。
3) 人员和营销提醒
“本周六的高影响事件 → 调整人员/投放广告/延长营业时间。”
4) 性能上下文层
当流量激增或下降时,用户可以看到原因(当地事件、干扰等)——减少猜测。
该 API 将地址转化为基于事件的人流上下文——这样任何仪表板都可以显示即将发生的事情、其意义以及如何准备。
本地事件评分端点分析指定商家地址附近即将发生的本地事件,并为每个事件分配一个影响评分 - 这是一个预测指标,指示该事件对该地点顾客客流的影响可能性。
它将原始事件列表转化为可操作的零售情报。
{
"address": "10001",
"action": "events",
"persona": "traveler",
"interests": ["music", "food"],
"language": "en",
"start_date": "",
"end_date": "",
"business_type": ""
}
地方活动 - 端点功能
| 对象 | 描述 |
|---|---|
address |
[必需] Business address or US zip code to analyze |
action |
可选 "events", "places", or "detect-type" |
persona |
可选 individual, family, teen, young_adult, traveler |
interests |
可选 Comma-separated interests (e.g., music,food) |
language |
可选 Type in en for english |
start_date |
可选 Description: Start date filter (YYYY-MM-DD) |
end_date |
可选 Description: End date filter (YYYY-MM-DD) |
business_type |
可选 Description: Used for business-mode impact scoring. Jeweler, furniture, coffee shop, ect... |
{"events":[{"name":"Valentine's Day Eve - Couples' Cooking Class","date":"2026-02-11","type":"Cooking Class","description":"Learn to prepare a romantic three-course meal with your significant other, just in time for Valentine's Day. Includes a complimentary glass of wine per person.","impact":"medium","impactReason":"Couples are often in a gifting mood around Valentine's Day. While not directly jewelry-focused, the romantic atmosphere could inspire a visit to a jeweler for a 'dessert' gift."},{"name":"Art & Wine Wednesdays: 'Love in Bloom' Painting Workshop","date":"2026-02-11","type":"Art Workshop","description":"Unleash your inner artist with a guided painting session focusing on floral and romantic themes. Enjoy wine and light refreshments while you create your masterpiece.","impact":"low","impactReason":"Creative and romantic themes might subtly elevate a desire for beautiful objects, but it's not a direct driver for jewelry purchases. Participants are focused on their art."},{"name":"Local Farmers Market - Valentine's Day Edition","date":"2026-02-11","type":"Market","description":"Discover fresh produce, artisanal goods, handmade crafts, and special Valentine's Day treats from local vendors. Live acoustic music adds to the festive atmosphere.","impact":"low","impactReason":"While there will be gift-giving opportunities, the focus is on smaller, handcrafted items and food. Unlikely to directly lead to significant jewelry sales."},{"name":"Pre-Valentine's Day 'Pamper Yourself' Spa & Wellness Fair","date":"2026-02-11","type":"Wellness Event","description":"Indulge in mini-massages, sample organic skincare products, and learn about local wellness services. A perfect way to de-stress before the holiday.","impact":"medium","impactReason":"Often, self-care and pampering can lead to a desire for personal adornment. If attendees are treating themselves, a piece of jewelry could be a complementary splurge."},{"name":"Charity Gala: 'Hearts for Hope' Fundraiser","date":"2026-02-11","type":"Gala/Fundraiser","description":"An elegant evening of dinner, dancing, and a silent auction to benefit a local children's charity. Black-tie optional.","impact":"high","impactReason":"Attendees for a gala are often dressed up and likely anticipating a special occasion. Many will be looking for complementary accessories, making it a prime opportunity for jewelers. Silent auction donations could also spread brand awareness."},{"name":"The Woodlands Symphony Orchestra: 'Love Songs' Concert","date":"2026-02-11","type":"Concert","description":"Enjoy a special Valentine's program featuring classic and contemporary love songs performed by The Woodlands Symphony Orchestra. Perfect for a romantic evening out.","impact":"high","impactReason":"A romantic concert setting encourages couples to celebrate and often involves dressing up. Attendees might be considering a special gift for their partner, making it an excellent time to showcase jewelry."},{"name":"Local Business Showcase: 'Boutique Finds & Sweethearts' Delights'","date":"2026-02-11","type":"Retail Showcase","description":"Explore unique gifts and services from local small businesses, with a focus on Valentine's Day. Includes demonstrations and special offers.","impact":"high","impactReason":"This event is specifically designed for local businesses to showcase their offerings for Valentine's Day. A jeweler would be a perfect fit and could directly engage with customers actively seeking gifts."}],"meta":{"address":"77380","usage":{"used":4,"limit":100},"generated_at":"2026-02-12T02:05:58.551Z"}}
curl --location --request POST 'https://zylalabs.com/api/11878/event+score+api/22581/local+event+api?address=1600 Pennsylvania Avenue NW' --header 'Authorization: Bearer YOUR_API_KEY'
| 标头 | 描述 |
|---|---|
授权
|
[必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。 |
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
事件评分 API 返回指定地点附近即将发生的事件列表,包括事件详细信息,如名称、日期、类型、描述,以及一个影响评分,指示其对人流的潜在影响,以及该评分背后的理由
响应数据中的关键字段包括“事件”(一个事件对象数组),每个事件包含“名称”“日期”“类型”“描述”“影响”和“影响原因”,提供对每个事件相关性的全面洞见
用户可以通过指定参数来自定义他们的请求,例如“角色”(例如,个人,家庭),“兴趣”(例如,音乐,食物),“日期范围”,“事件与地点模式”,“语言”(英语/西班牙语)和“商业类型”以便于零售导向的评分
响应数据以JSON格式组织,其中包含一个“events”数组,包含各个事件对象。每个对象包括结构化字段,以便于访问事件详情、影响评分和推理
数据来自各种地方活动列表、社区日历和与活动组织者的合作,从而确保广泛的活动范围,反映当地的兴趣和活动
典型的用例包括通过识别对人力调整、营销活动和了解与社区活动相关的当地交通模式的高影响事件来增强零售策略
用户可以通过将返回的数据整合到他们的仪表板中,来可视化即将发生的事件,评估其对客流量的潜在影响,并就人员配置和营销工作做出明智的决定
通过定期更新、与多个来源进行验证和质量检查来维护数据的准确性,以确保事件细节是最新和相关的,为用户提供可靠的洞察
服务级别:
100%
响应时间:
1,737ms
服务级别:
99%
响应时间:
1,038ms
服务级别:
100%
响应时间:
116ms
服务级别:
100%
响应时间:
4,115ms
服务级别:
100%
响应时间:
52ms
服务级别:
100%
响应时间:
62ms
服务级别:
100%
响应时间:
134ms
服务级别:
100%
响应时间:
454ms
服务级别:
100%
响应时间:
158ms
服务级别:
100%
响应时间:
54ms