本教程详细介绍了如何利用python的`requests`库与gbgb api交互，以自动化方式抓取指定日期范围和特定赛狗赛道的比赛结果。文章涵盖了api参数的理解、日期范围的程序化生成、http请求的发送、json数据的解析与筛选，以及最终数据的持久化存储，旨在提供一个结构清晰、可复用的数据抓取解决方案。

自动化抓取GBGB赛狗比赛结果

在进行数据分析或建立预测模型时，从特定网站获取大量结构化数据是一项常见需求。对于GBGB（Great British Greyhound Board）的赛狗比赛结果，手动通过网站界面或逐个URL抓取是极其耗时且效率低下的。本教程将展示如何利用Python及其强大的requests库，结合GBGB提供的API接口，实现对指定日期范围和特定赛道的比赛结果进行高效、自动化的抓取。

理解GBGB API接口

GBGB提供了一个API接口，允许开发者通过HTTP请求获取比赛结果数据。根据提供的信息，核心的API端点是： https://api.gbgb.org.uk/api/results

此端点支持以下关键查询参数：

• page: 页码，用于分页。
• itemsPerPage: 每页显示的条目数。例如，200表示每页获取200条记录。
• date: 指定查询的日期，格式为YYYY-MM-DD。这是实现日期范围抓取的关键。
• race_type: 比赛类型，例如race。

通过组合这些参数，我们可以构建出请求URL，例如： https://api.gbgb.org.uk/api/results?page=1&itemsPerPage=200&date=2025-11-01&race_type=race 这将返回2025年11月1日的所有比赛结果中的前200条记录。

设置开发环境

在开始之前，请确保您的Python环境中安装了requests库。如果尚未安装，可以通过以下命令进行安装：

pip install requests

程序化生成日期范围

为了实现指定日期范围的抓取，我们需要编写代码来迭代生成所需的日期字符串。这通常涉及到一个嵌套循环，外层循环处理月份，内层循环处理该月份中的每一天。

from datetime import datetime, timedelta
import requests
import json

# 定义抓取的起始和结束日期
start_date = datetime(2025, 10, 1) # 例如，从2025年10月1日开始
end_date = datetime(2025, 12, 31)   # 到2025年12月31日结束

# 存储所有抓取到的数据
all_results = []

# API基础URL和固定参数
base_url = "https://api.gbgb.org.uk/api/results"
params = {
    'page': '1',
    'itemsPerPage': '200', # 假设每页最多200条，根据实际情况调整或处理分页
    'race_type': 'race'
}

# 循环生成日期
current_date = start_date
while current_date <= end_date:
    # 格式化日期为 YYYY-MM-DD
    params['date'] = current_date.strftime('%Y-%m-%d')

    # 打印当前正在抓取的日期，便于跟踪进度
    print(f"正在抓取 {params['date']} 的数据...")

    # 移动到下一天
    current_date += timedelta(days=1)

上述代码片段初始化了起始和结束日期，并使用datetime和timedelta对象来逐天递增，确保每个日期都能被处理。

发送API请求与错误处理

在日期循环内部，我们将使用requests.get()方法向API发送请求，并处理可能出现的各种网络或API错误。

N世界

一分钟搭建会展元宇宙

138 查看详情

# ... (前面的代码保持不变)

current_date = start_date
while current_date <= end_date:
    params['date'] = current_date.strftime('%Y-%m-%d')
    print(f"正在抓取 {params['date']} 的数据...")

    try:
        response = requests.get(base_url, params=params)
        response.raise_for_status()  # 检查HTTP请求是否成功 (200 OK)

        # 将响应内容解析为JSON
        page_context_dict = response.json()

        # GBGB API的实际数据通常在 'items' 键中
        items = page_context_dict.get('items', []) 

        # 将抓取到的数据添加到总列表中
        all_results.extend(items)

    except requests.exceptions.HTTPError as errh:
        print(f"HTTP错误 (日期: {params['date']}): {errh}")
    except requests.exceptions.ConnectionError as errc:
        print(f"连接错误 (日期: {params['date']}): {errc}")
    except requests.exceptions.Timeout as errt:
        print(f"请求超时 (日期: {params['date']}): {errt}")
    except requests.exceptions.RequestException as err:
        print(f"请求异常 (日期: {params['date']}): {err}")
    except json.JSONDecodeError as json_err:
        print(f"JSON解析错误 (日期: {params['date']}): {json_err} - 响应内容: {response.text[:200]}") # 打印部分响应内容辅助调试

    current_date += timedelta(days=1)

# ... (后续数据处理和保存)

response.raise_for_status()是一个非常有用的方法，它会在HTTP请求返回错误状态码（如4xx或5xx）时抛出HTTPError异常，从而方便我们捕获并处理这些问题。

筛选特定赛道数据

API返回的数据可能包含所有赛道的信息。如果我们需要筛选出特定赛道（例如“Swindon”）的比赛结果，可以在获取到每日数据后进行过滤。

# ... (前面的代码保持不变)

desired_track = "Swindon" # 定义您感兴趣的赛道名称

current_date = start_date
while current_date <= end_date:
    params['date'] = current_date.strftime('%Y-%m-%d')
    print(f"正在抓取 {params['date']} 的数据...")

    try:
        response = requests.get(base_url, params=params)
        response.raise_for_status()

        page_context_dict = response.json()
        items = page_context_dict.get('items', [])

        # 筛选特定赛道的数据
        specific_track_items = []
        for item in items:
            if "trackName" in item and item["trackName"] == desired_track:
                specific_track_items.append(item)

        all_results.extend(specific_track_items) # 将筛选后的数据添加到总列表

    except Exception as e: # 捕获更广泛的异常，或者保持细致的异常捕获
        print(f"处理日期 {params['date']} 时发生错误: {e}")

    current_date += timedelta(days=1)

# ... (后续数据保存)

这里，我们遍历每天获取到的items列表，检查每个item字典中是否存在trackName键，并且其值是否与desired_track匹配。

完整代码示例

将上述所有组件整合，形成一个完整的Python脚本：

from datetime import datetime, timedelta
import requests
import json

def scrape_gbgb_results(start_date_str, end_date_str, desired_track_name, output_filename="gbgb_results.json"):
    """
    从GBGB API抓取指定日期范围和特定赛道的比赛结果。

    Args:
        start_date_str (str): 起始日期，格式 'YYYY-MM-DD'。
        end_date_str (str): 结束日期，格式 'YYYY-MM-DD'。
        desired_track_name (str): 目标赛道的名称，例如 "Swindon"。
        output_filename (str): 结果保存的文件名，默认为 "gbgb_results.json"。
    """
    try:
        start_date = datetime.strptime(start_date_str, '%Y-%m-%d')
        end_date = datetime.strptime(end_date_str, '%Y-%m-%d')
    except ValueError:
        print("日期格式不正确。请使用 'YYYY-MM-DD' 格式。")
        return

    all_results = []
    base_url = "https://api.gbgb.org.uk/api/results"
    params = {
        'page': '1',
        'itemsPerPage': '200', # 根据API限制和需求调整
        'race_type': 'race'
    }

    current_date = start_date
    while current_date <= end_date:
        params['date'] = current_date.strftime('%Y-%m-%d')
        print(f"正在抓取 {params['date']} 的数据...")

        try:
            response = requests.get(base_url, params=params, timeout=10) # 设置超时
            response.raise_for_status() # 如果状态码不是200，则抛出HTTPError

            page_context_dict = response.json()
            items = page_context_dict.get('items', [])

            specific_track_items = []
            for item in items:
                if "trackName" in item and item["trackName"] == desired_track_name:
                    specific_track_items.append(item)

            if specific_track_items: # 仅当有筛选结果时才添加
                all_results.extend(specific_track_items)

        except requests.exceptions.HTTPError as errh:
            print(f&quot;HTTP错误 (日期: {params['date']}): {errh}")
        except requests.exceptions.ConnectionError as errc:
            print(f"连接错误 (日期: {params['date']}): {errc}")
        except requests.exceptions.Timeout as errt:
            print(f"请求超时 (日期: {params['date']}): {errt}")
        except requests.exceptions.RequestException as err:
            print(f"请求异常 (日期: {params['date']}): {err}")
        except json.JSONDecodeError as json_err:
            print(f"JSON解析错误 (日期: {params['date']}): {json_err}. 响应内容开头: {response.text[:200]}")
        except Exception as e:
            print(f"处理日期 {params['date']} 时发生未知错误: {e}")

        current_date += timedelta(days=1)

    # 将所有抓取到的数据写入JSON文件
    if all_results:
        with open(output_filename, 'w', encoding='utf-8') as f:
            json.dump(all_results, f, ensure_ascii=False, indent=4)
        print(f"数据已成功保存到 {output_filename}，共 {len(all_results)} 条记录。")
    else:
        print(f"在指定日期范围和赛道 '{desired_track_name}' 下未找到任何数据。")

if __name__ == "__main__":
    # 示例调用
    scrape_gbgb_results(
        start_date_str="2025-10-01",
        end_date_str="2025-10-31",
        desired_track_name="Swindon",
        output_filename="swindon_results_october.json"
    )

    # 您可以根据需要更改日期范围和赛道名称
    # scrape_gbgb_results(
    #     start_date_str="2025-11-01",
    #     end_date_str="2025-11-15",
    #     desired_track_name="Hove",
    #     output_filename="hove_results_early_november.json"
    # )

注意事项与最佳实践

1. API速率限制 (Rate Limiting): 频繁或大量请求可能会触发API的速率限制，导致请求被拒绝。虽然GBGB API文档中未明确提及，但在实际操作中应注意。可以考虑在每次请求之间添加time.sleep()来引入延迟，例如time.sleep(0.5)。
2. 分页处理: 当前代码中itemsPerPage设置为200。如果某天的比赛结果超过200条，并且API支持多页，您可能需要在一个日期内部再增加一个循环来处理page参数，直到没有更多数据返回。
3. 数据结构变化: API返回的JSON数据结构可能会随时间变化。在编写代码时，应考虑到健壮性，例如使用.get()方法访问字典键，以避免因键不存在而引发错误。
4. 错误处理: 完善的错误处理机制对于数据抓取至关重要。上述代码已经包含了对常见requests异常和json解析错误的捕获，这有助于诊断和解决问题。
5. 目标赛道名称: desired_track_name必须与API返回数据中的trackName字段完全匹配，包括大小写。
6. 文件保存格式: 示例代码将数据保存为JSON格式，这是一种易于机器读取和解析的格式。根据需求，您也可以将其转换为CSV、数据库记录等其他格式。
7. 代码可复用性: 将抓取逻辑封装在函数中（如scrape_gbgb_results），可以提高代码的可读性和复用性。

总结

通过本教程，我们学习了如何利用Python的requests库与GBGB API接口进行交互，从而高效地抓取指定日期范围和特定赛道的赛狗比赛结果。这种自动化方法不仅节省了大量手动操作的时间，也为后续的数据分析和应用提供了可靠的数据源。掌握API接口的参数、程序化日期生成以及健壮的错误处理是实现此类数据抓取任务的关键。

以上就是使用Python和GBGB API高效抓取指定日期范围和赛道比赛结果教程的详细内容，更多请关注其它相关文章！

# js  # json  # app  # python  # 转换为  # 解决问题  # 赛狗  # 复用  # 分页  # 每页  # 数据结构  # red  # python脚本  # 持久化存储  # 开发环境  # 状态码  # win  # ai  # csv  # yy  # 说网站建设  # 云南seo书籍教程  # SEO入门书籍封面封底  # 重重seo  # 长沙财务优化招聘网站  # 怎么找美食啊网站推广呢  # 菏泽一站式网站优化  # 罗湖如何建网站推广店  # 谷歌seo免费操作  # 荆门哪里有网站建设推荐  # 如何将  # 数据包  # 抛出 

相关栏目： 【 科技资讯46185 】 【 网络学院92790 】

相关推荐： vivo手机互传视频怎么操作_vivo手机互传视频详细传输方法  Win11怎么开启省电模式_Win11电池节电模式自动开启  单12V-2×6实现为RTX 5090供电750W！甚至都没敢跑分  将HTML Canvas内容转换为可上传的图像文件（File对象）  从OpenAI API响应中高效提取生成文本  CSS布局：解决全屏元素100%尺寸与外边距导致的页面溢出问题  sublime如何只显示或隐藏特定类型文件_sublime侧边栏文件过滤  “在文档元素之后找到了标记”是什么错误？ 检查并修复XML中多个根元素的3个方法  C++如何操作注册表_Windows平台下C++读写注册表的API函数详解  响应式容器内容自动缩放与宽高比维持教程  消息称三星明年 2 月正式发布 HBM4，与 SK 海力士同台竞技  PySpark中高效提取字符串右侧可变长度数字：使用regexp_extract  如何使用spryker/configurable-bundles-products-resource-relationship模块解决复杂产品捆绑关系难题  必由学官网快捷入口 必由学网页版在线学习平台  Win11蓝牙耳机断连怎么解决 Win11蓝牙设置重新配对与驱动更新【技巧】  将JSON对象数组转置为键值对列表的实用指南  微信客户端如何收红包_微信客户端接收红包使用教程  CSS布局中意外空白：解决padding-top导致的顶部间距问题  GemBox Document HTML转PDF垂直文本渲染问题及解决方案  win11专注助手在哪 Win11免打扰模式设置与自动化规则【指南】  解决 Vaadin 8 中大文件音频播放与定位时出现的 IOException  Composer如何解决json扩展缺失的错误  菜鸟取件码是什么怎么查 最全查询渠道汇总  J*a实现学校排课程序_面向对象结构化项目示例  冬*霸灯泡不亮怎么办_浴霸取暖灯一盏不亮的灯座清洁修复法  Go语言中对Map值调用带指针接收者方法：原理与最佳实践  4399网页游戏电脑版全新入口 4399电脑端在线玩指南  Spring Boot嵌入式服务器与J*a EE：功能支持深度解析  怎么在浏览器上运行HTML文件_浏览器运行HTML文件技巧【技巧】  Win10文件资源管理器“此电脑”分组怎么关 Win10恢复经典视图【技巧】  Excel Power Pivot如何处理XML数据源 构建高级数据模型  CSS实现侧边栏导航项全宽圆角悬停背景效果  Yandex免登录网页版地址 Yandex搜索引擎官方访问入口  126邮箱账号注册 电脑版登录入口  响应式CSS Grid布局：优化网格项在小屏幕下的堆叠与宽度适配  163邮箱网页版入口导航平台 163邮箱网页版登录入口官网导航  腾讯视频怎么举报不良内容_腾讯视频内容举报流程与违规信息处理方法  J*aScript中在Map循环中检测并处理空数组元素  Lar*el Excel导入时生成自定义递增ID的策略与实践  单射、满射与双射的关系 一文理清所有逻辑  AO3官方镜像站点汇总 AO3同人作品网页版直达链接  c++如何使用Catch2编写单元测试_c++简洁易用的BDD风格测试框架  向日葵客户端怎么进行远程CentOS控制_向日葵客户端远程CentOS控制操作教程  XML中包含HTML标签导致解析错误？ 正确嵌入非XML数据的两种方法  Python异步编程实践：使用Binance API构建实时交易数据流  Composer中的^和~符号代表什么_精通Composer版本号语义化约束  神经网络二分类模型训练异常：高损失与完美验证准确率的排查与修正  Go语言HTML解析：利用Goquery精准获取指定元素内容  Win10怎么制作U盘启动盘 Win10系统安装U盘制作教程【详解】  《马克思佩恩3》早期版本曝光 UI设计曾多次调整！