---
title: "SofaScore venue"
method: GET
path: "/sofascore/venue"
tags: ["SofaScore"]
---

# SofaScore venue

`GET /sofascore/venue`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sofascore/venue`
- Auth: API key in header `x-api-key`

Returns one venue (stadium or arena): name, capacity, city, country, coordinates, its home teams, the venue-wide match totals (matches, goals, home and away win shares, and for football cards and corners per game) and a per-sport record in `sports`, most matches first. `hidden` venues, such as NBA arenas, have no venue-wide match list in venue-events and are listed per competition season instead. An unknown venue id answers 404. Get `id` from search-typed with `type` `venues`, from tournament-venues or from an event's venue.

## Query parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreVenueResponseDoc
  - `code` integer
  - `data` SofascoreVenueResponse
    - `fetched_at` string
    - `main_teams` SofascoreTeamRef[]
      - `country` string: Country the team belongs to.
      - `id` integer: SofaScore team id. Use it with the team endpoints.
      - `name` string: Full team name.
      - `national` boolean: True for a national team.
      - `short_name` string: Shortened team name.
      - `slug` string: URL slug of the team on SofaScore.
    - `source_url` string
    - `sports` SofascoreVenueSportStatistics[]
      - `draw_percentage` number
      - `goals_scored` number
      - `home_win_percentage` number: HomeWinPercentage and DrawPercentage are percentages (0 to 100).
      - `sport` string
      - `total_matches` integer
    - `totals` SofascoreVenueTotals
      - `avg_corner_kicks_per_game` number
      - `avg_red_cards_per_game` number
      - `away_team_goals_scored` number
      - `away_team_wins_percentage` number
      - `draws_percentage` number
      - `home_team_goals_scored` number
      - `home_team_wins_percentage` number
      - `total_matches` integer
    - `venue` SofascoreVenueRecord
      - `capacity` integer
      - `city` string
      - `country` string
      - `hidden` boolean: Hidden is SofaScore's hidden flag. A hidden venue has no venue-wide match list (venue-events answers not found without tournament and season), but its matches are still listed per competition season.
      - `id` integer
      - `latitude` number
      - `longitude` number
      - `name` string
      - `slug` string
      - `state` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)