Pricing

from $2.00 / 1,000 record scrapeds

TheSportsDB Scraper

Scrape TheSportsDB - multi-sport database (football, basketball, NFL, NHL, MLB, F1). Leagues, teams, players, past and upcoming events. Returns names, badges/logos, stadiums, founded year, country, league, season. Free.

Pricing

from $2.00 / 1,000 record scrapeds

Rating

0.0

(0)

Developer

Gio

Actor stats

Bookmarked

Total users

Monthly active users

3 months ago

Last modified

Categories

E-commerce

Developer tools

You can access the TheSportsDB Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "0pHH9v5XgQuXhivRz"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/gio21~thesportsdb-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-gio21-thesportsdb-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/gio21~thesportsdb-scraper/runs": {
      "post": {
        "operationId": "runs-sync-gio21-thesportsdb-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/gio21~thesportsdb-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-gio21-thesportsdb-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "dataset"
        ],
        "properties": {
          "dataset": {
            "title": "Dataset",
            "enum": [
              "leagues-by-country",
              "teams-by-league",
              "team-search",
              "player-search",
              "next-events-by-league",
              "last-events-by-league"
            ],
            "type": "string",
            "description": "'leagues-by-country' (list leagues), 'teams-by-league' (teams in a league), 'team-search' (search by name), 'player-search' (search by name), 'next-events-by-league' (upcoming events), 'last-events-by-league' (past events).",
            "default": "team-search"
          },
          "query": {
            "title": "Query",
            "type": "string",
            "description": "For team-search/player-search: name. For teams/events-by-league: league name (e.g. 'English_Premier_League'). For leagues-by-country: country (e.g. 'Brazil')."
          },
          "apiKey": {
            "title": "TheSportsDB API key (optional)",
            "type": "string",
            "description": "Your TheSportsDB key. Default uses public key '3' which is rate-limited. Get yours at thesportsdb.com/api.php",
            "default": "3"
          },
          "maxItems": {
            "title": "Max records",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Max records returned.",
            "default": 100
          },
          "debug": {
            "title": "Debug logs",
            "type": "boolean",
            "description": "Verbose logging.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

TheSportsDB Scraper OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for TheSportsDB Scraper from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

TheSportsDB Scraper API in Python

TheSportsDB Scraper API in JavaScript

TheSportsDB Scraper API through CLI

TheSportsDB Scraper API

TheSportsDB Scraper

parseforge/thesportsdb-scraper

Scrapes teams, players, leagues, events, and live scores from TheSportsDB. Returns each record as a flat row with names, badges, stadiums, and season details.

ParseForge

Thesportsdb Scraper

fortuitous_pirate/thesportsdb-scraper

Scrape sports data from TheSportsDB: leagues, teams, players, and events across soccer, basketball, baseball, football, and more.

Fortuitous Pirate

TheSportsDB Multi-Sport API Wrapper

jungle_synthesizer/thesportsdb-multi-sport-api-wrapper

Fetch leagues, teams, players, and match events from TheSportsDB — the free multi-sport metadata API covering soccer, basketball, baseball, American football, and dozens more sports worldwide. Bring your own free or Patreon API key. Results are schema-normalised and dataset-ready.

BowTiedRaccoon

TheSportsDB Scraper - Teams, Players & Data

benthepythondev/thesportsdb-scraper

Search TheSportsDB for sports teams or players by name and get structured data: name, sport, league, country, stadium, formed year, social links, badge/thumbnail and description. Fast and reliable via the public TheSportsDB API. For sports data, fan apps, dashboards and datasets.

Ben

NFL Data Scraper

crawlerbros/nfl-data-scraper

Scrape NFL statistics and data, teams, players, game schedules, and standings for the National Football League via TheSportsDB. Free public API, no registration required.

Crawler Bros

Balldontlie Scraper

fortuitous_pirate/balldontlie-scraper

Fetch sports data including players, teams, and past events from TheSportsDB free API. Search NBA, NFL, MLB, Soccer players and get game results. No API key required.

Fortuitous Pirate

Sports Data Scraper — Teams, Players & Fixtures

ponderable_hydrometer/sportsdb-scraper

Sports data from TheSportsDB — search teams and players, list league teams, and get fixtures and results across football, basketball, NFL and more. Free test key or bring your own.

Ponderable Hydrometer

TheSportsDB

moving_beacon-owner1/my-actor-89

Fetches sports data like teams, players, and events. Quick start: `{ "mode": "searchTeam", "query": "Arsenal" }` Modes include searching teams/players, league teams/events, past & upcoming matches, team/player details, recent & next fixtures, and listing leagues, sports, countries, and seasons.