GridCast Sports Guide · GPT-Aktionen

{
  "openapi": "3.1.0",
  "info": {
    "title": "Gridcast Sports Schedule API",
    "description": "Real-time sports game schedules, broadcast information, live scores, and betting odds. Use this API to answer questions like 'Where can I watch the Dodgers game tonight?' or 'What channel is the NBA game on?'",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://gridcast.co"
    }
  ],
  "paths": {
    "/api/games": {
      "get": {
        "operationId": "getGames",
        "summary": "Get today's sports game schedule with broadcast info",
        "description": "Returns a list of today's games across all major sports leagues, including which TV channel or streaming service carries each game, live scores, game status, and betting odds. Ideal for answering 'where to watch' questions.",
        "parameters": [
          {
            "name": "sport",
            "in": "query",
            "required": false,
            "description": "Filter by sport. Options: mlb, nba, nhl, nfl, mls, ncaaf, ncaab, golf, ufc, f1. Omit for all sports.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "date",
            "in": "query",
            "required": false,
            "description": "Date in YYYY-MM-DD format (Pacific Time). Defaults to today.",
            "schema": {
              "type": "string",
              "example": "2026-04-04"
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "Response format. Use 'text' for a human-readable plain-text summary ideal for AI responses. Omit for full JSON.",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "text"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of games with broadcast and score information",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "date": {
                      "type": "string",
                      "description": "The queried date in YYYY-MM-DD format"
                    },
                    "sport": {
                      "type": "string",
                      "description": "The filtered sport, or 'all'"
                    },
                    "count": {
                      "type": "integer",
                      "description": "Total number of games"
                    },
                    "games": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "sport": {
                            "type": "string"
                          },
                          "league": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "scheduled",
                              "in_progress",
                              "final",
                              "postponed",
                              "delayed"
                            ]
                          },
                          "startTime": {
                            "type": "string",
                            "description": "ISO 8601 UTC start time"
                          },
                          "startTimePT": {
                            "type": "string",
                            "description": "Start time in Pacific Time"
                          },
                          "homeTeam": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "abbreviation": {
                                "type": "string"
                              },
                              "record": {
                                "type": "string"
                              },
                              "score": {
                                "type": "integer",
                                "nullable": true
                              }
                            }
                          },
                          "awayTeam": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "abbreviation": {
                                "type": "string"
                              },
                              "record": {
                                "type": "string"
                              },
                              "score": {
                                "type": "integer",
                                "nullable": true
                              }
                            }
                          },
                          "venue": {
                            "type": "string"
                          },
                          "broadcasts": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string",
                                  "description": "Platform display name"
                                },
                                "url": {
                                  "type": "string",
                                  "description": "Direct watch URL"
                                },
                                "subscriptionRequired": {
                                  "type": "boolean"
                                },
                                "isFree": {
                                  "type": "boolean"
                                },
                                "monthlyPrice": {
                                  "type": "string"
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string",
                  "description": "Human-readable game summary"
                }
              }
            }
          }
        }
      }
    }
  }
}