過去番組データを取得

POST/dra

テーブル: d_ra(番組データ過去)

過去のレース情報を取得します。

リクエストURL

POST https://dev.api.bigtime.world/v1/dra?api_key=API_KEY

クエリパラメータ

パラメータ型必須説明
api_keystring必須API Key例: API_KEY

リクエストボディ

パラメータ型必須説明
start_racedatestring-開始日(YYYYMMDD形式)例: 20251101
end_racedatestring-終了日(YYYYMMDD形式)例: 20251130
racekeystring-レースキー(8桁)例: 05250101

リクエスト例

期間指定で取得

{
  "start_racedate": "20251101",
  "end_racedate": "20251130"
}

サンプルコード

import requests

# ダッシュボードで取得した値をそれぞれ貼り付け
# API_KEY: APIキー(アプリ共通)
# YOUR_AUTH_KEY: 認証キー (x-user-key)

url = "https://dev.api.bigtime.world/v1/dra"

params = {"api_key": "API_KEY"}
headers = {
    "Content-Type": "application/json",
    "x-user-key": "YOUR_AUTH_KEY"
}

payload = {
  "start_racedate": "20251101",
  "end_racedate": "20251130"
}

response = requests.post(url, params=params, headers=headers, json=payload)
data = response.json()

print(data)

レスポンス

成功時は以下の形式でデータが返されます。

サンプルレスポンス

{
  "request": {
    "parameters": {
      "start_racedate": "20251101",
      "end_racedate": "20251130",
      "racekey": "05250101"
    }
  },
  "result": {
    "status": 200,
    "endpoint_uri": "/v1/dra",
    "membershipLimit": "paid members",
    "result_count": 1,
    "data": [
      {
        "data_classification": "6",
        "holding_classification": "1",
        "racekey": "06255601",
        "racedate": "20251221",
        "post_time": "0955",
        "original_post_time": "sample",
        "racecourse_cd": "06",
        "distance": "1200",
        "track_type": "2",
        "turn_cd": "1",
        "inside_outside_cd": "1",
        "course_cd": "1",
        "class_cd": "11",
        "insignia_cd": "002",
        "condition_cd": "A3",
        "weight_cd": "3",
        "grade_cd": "5",
        "race_name": "朝日杯フューチュリティステークス",
        "howmany_times": "第77回",
        "headcount": 16,
        "turf_condition_cd": "30",
        "weather_cd": "2",
        "prize_win": 560,
        "prize_show": 220,
        "prize_place": 140,
        "prize_4th": 84,
        "prize_5th": 56,
        "inclusion1": 400,
        "inclusion2": 0,
        "cancel_horse": "111111111111111100",
        "assumption_time": "1132",
        "correction_flag": "sample",
        "win5_number": "1",
        "updated_at": "2025-12-21T10:10:25.000Z"
      }
    ]
  }
}

レスポンスフィールド

パラメータ型必須説明
data_classificationstring-データ区分例: 6
holding_classificationstring-開催区分例: 1
racekeystring-レースキー(8桁)例: 06255601
racedatestring-開催日例: 20251221
post_timestring-発走時刻(HHMM)例: 0955
original_post_timestring| null-変更前発走時刻
racecourse_cdstring-競馬場コード(01:札幌〜10:小倉)例: 06
distancestring-距離(m)例: 1200
track_typestring-トラック種別(1:芝, 2:ダート, 3:障害)例: 2
turn_cdstring-回り(1:右, 2:左, 9:直線)例: 1
inside_outside_cdstring-内外コード例: 1
course_cdstring-コースコード例: 1
class_cdstring-クラスコード例: 11
insignia_cdstring-記号コード例: 002
condition_cdstring-条件コード例: A3
weight_cdstring-重量種別例: 3
grade_cdstring| null-グレード(1:G1, 2:G2, 3:G3, 5:特別, 6:リステッド)例: 5
race_namestring| null-レース名例: 朝日杯フューチュリティステークス
howmany_timesstring| null-第何回開催例: 第77回
headcountinteger-出走頭数例: 16
turf_condition_cdstring| null-芝馬場状態コード例: 30
weather_cdstring| null-天候コード例: 2
prize_wininteger-1着賞金(万円)例: 560
prize_showinteger-2着賞金(万円)例: 220
prize_placeinteger-3着賞金(万円)例: 140
prize_4thinteger-4着賞金(万円)例: 84
prize_5thinteger-5着賞金(万円)例: 56
inclusion1integer-付加賞金1例: 400
inclusion2integer-付加賞金2例: 0
cancel_horsestring-出走取消馬フラグ例: 111111111111111100
assumption_timestring| null-想定タイム例: 1132
correction_flagstring| null-訂正フラグ
win5_numberstring| null-WIN5対象レース番号例: 1
updated_atstring-更新日時例: 2025-12-21T10:10:25.000Z

関連エンドポイント