# Google Sports Results

Search the sports box Google shows for a team, league or scores query (for example "bayern munich" or "nba scores") and get the games with teams, scores, status, date, time and tournament stage, the team or league header with ranking, recent and upcoming games, and the top standings rows when Google shows them. A query without a sports box returns has_box false and no games, and is not billed. A successful request with a sports box costs 1 credit. Google shows times in the time zone given in time_zone.

- **Documentation:** [https://scrappa.co/docs/google-sports-api/google_sports_search](https://scrappa.co/docs/google-sports-api/google_sports_search)
- **API group:** Google Sports API
- **Endpoint:** `GET https://scrappa.co/api/google/sports`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | string | Yes | Team, league or scores query, for example "bayern munich" or "nba scores" |
| `hl` | string | No | Interface language code (e.g., en, de) |
| `gl` | string | No | Country code: us, de or gb |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/google/sports?q=bayern+munich&hl=en&gl=us"
```

## Example response

```json
{
    "search_parameters": {
        "engine": "google_sports",
        "q": "bayern munich",
        "hl": "en",
        "gl": "us"
    },
    "sports_results": {
        "has_box": true,
        "title": "FC Bayern Munich",
        "rankings": "1st in Bundesliga",
        "team": {
            "name": "FC Bayern Munich"
        },
        "time_zone": "All times are in Eastern Time",
        "games": [
            {
                "tournament": "UEFA Champions League",
                "status": "Full-time",
                "date": "Yesterday",
                "teams": [
                    {
                        "name": "Atl\u00e9tico",
                        "team_id": "/m/0lg7v",
                        "score": 0
                    },
                    {
                        "name": "Bayern",
                        "team_id": "/m/0175rc",
                        "score": 2
                    }
                ]
            },
            {
                "game_id": "/g/11nqxxgyjp",
                "date": "Sat, Nov 7",
                "time": "9:30 AM",
                "start_time": "2026-11-07T14:30:00Z",
                "teams": [
                    {
                        "name": "Mainz",
                        "team_id": "/m/051qvn"
                    },
                    {
                        "name": "Bayern",
                        "team_id": "/m/0175rc"
                    }
                ]
            }
        ],
        "standings": {
            "title": "Bundesliga",
            "columns": [
                {
                    "key": "MP",
                    "label": "Matches played"
                },
                {
                    "key": "Pts",
                    "label": "Points"
                }
            ],
            "rows": [
                {
                    "position": 1,
                    "team": "Bayern",
                    "values": {
                        "MP": "8",
                        "Pts": "18"
                    }
                }
            ]
        }
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | One or more query parameters failed validation, or the country is not supported. |
| 503 | Sports Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)