Real-Time Events Search

Search Local & Online Events such as Concerts, Sports Matches & Events, Workshops, Festivals, Movies and More on Google in Real-Time.

原始信息汇总

Real-Time Events Search API 数据集概述

基本信息

• API名称：Real-Time Events Search
• 提供商：OpenWeb Ninja
• 类别：Data
• 当前版本：v1
• 订阅者数量：1680
• 流行度评分：9.9
• 服务等级：100%
• 延迟：2332ms
• 测试通过率：100%

功能描述

此API用于实时搜索网络上的事件。事件类型包括：音乐会、体育赛事、研讨会、节日、电影以及Google Events支持的其他更多类型。

定价计划

• BASIC：$0.00 / 月
• PRO：$25.00 / 月
• ULTRA：$75.00 / 月
• MEGA：$150.00 / 月

端点

1. Search Events

   • 方法：GET
   • 路径：/search-images
   • 功能：实时搜索本地公共事件。支持Google Events上可用的过滤器和选项，如日期和在线/虚拟过滤器。

2. Event Details

   • 方法：GET
   • 路径：/event-details
   • 功能：通过事件ID（即事件的 event_id 字段）获取特定事件的详细信息。

认证方式

使用 X-RapidAPI-Host 和 X-RapidAPI-Key 头部进行认证。

• X-RapidAPI-Host 值应为：“real-time-image-search.p.rapidapi.com”

响应结构

所有JSON响应体均包含以下字段：

• status：状态（"ERROR" 或 "OK"）
• request_id：请求ID
• error：如果请求失败，包含 message 和 code 字段
• data：如果请求成功，包含数据

速率限制

• 每个订阅计划定义了每月允许的最大请求数（配额）以及以RPS（每秒请求数）表示的速率限制。
• 所有免费计划（例如BASIC）的速率限制为每小时1000个请求。
• 响应头中包含速率限制信息：
  • x-ratelimit-requests-limit
  • x-ratelimit-requests-remaining
  • x-ratelimit-requests-reset
• 达到速率限制时，RapidAPI网关将返回429错误。

错误处理

API使用HTTP状态码指示问题。

• 400 Bad Request：请求格式错误或缺少必需参数。
• 403 Forbidden：未订阅API或API密钥无效。
• 404 Not Found：未找到请求的资源。
• 429 Too Many Requests：达到订阅计划的速率限制。
• 5XX Server Error：服务器处理请求时出现问题。

支持与联系

• 支持邮箱：[e-mail]
• Discord：https://discord.gg/wxJxGsZgha
• LinkedIn：https://www.linkedin.com/company/openwebninja-api

常见用例

• 事件分析与洞察
• 事件发现平台
• 旅游和旅游网站
• 智慧城市应用
• 营销与推广

搜集汇总

背景与挑战

背景概述

该数据集提供实时事件搜索功能，可查询包括音乐会、体育赛事、研讨会、节日庆典、电影等多种本地及在线活动信息。