fotmob 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc5115b39ae5263043d1efc3a66205b9e005c978c442d7aa9c246065b80fdbfb
-  data.tar.gz: 02461ba1b0750f0614df5ad2baf18eba734deb810da9a6f99619c0dfa61fefe0
+  metadata.gz: 2db5d9b53f38dd3532d6db31d0442b64193ee9df642f0e27e5cafca07e7ca5e7
+  data.tar.gz: ec6df784201636a0f4e5cb2585e022fb10ccad33e5de8dc8ba3311f6d0ef3f7d
 SHA512:
-  metadata.gz: 0cfe6fc4a515cb3ef0431a3c7d62ce94227c2c4eb78d925489e2051e1f8fe3b0af84ad399a845272860e5449a868e991e54058dc6a6393934fbf9c2d8e3ca000
-  data.tar.gz: 82c1c31b13f588eff307b5283f1b6fb9c571bf2ae5e3844f6feb0a296fd51bcbff9940aff9f185d6a4c939be76f3fe62c9a65ed05eed8004c1fcde7c7cc55901
+  metadata.gz: ea85bde7a3e7f9ca2e3a124fe0613a1e2df76e29311557ba69065bb7968833d343c5e43afe887c260552095d602677335aac8a1f3a0a45b865d3f4ee9514afbc
+  data.tar.gz: 3dab6a921e4a4b40b28f3d434c2e099760b69c4d0d2d8d291e41131c2b9013da8656a7d992de9a24b8acbb63d1da6f333cba52e8a10560aa4e2e1af7144e147e

data/CHANGELOG.md

@@ -5,51 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.1.0] - 2026-01-15
+## [0.2.0] - 2026-05-16
 
 ### Changed
-- Version bump for first stable release
-- Repository cleanup (removed build artifacts and test files)
-- Added MIT LICENSE file
-- Added CI status badge to README
+- Updated all API endpoints to match FotMob's current backend (`/api/data/`)
+- `get_matches` fully working — returns all matches across 150+ leagues for a date
+- `get_match_details` reimplemented via Next.js SSR data (full lineups, stats, events)
+- `get_match_details` now auto-refreshes build ID on stale deploys (transparent retry)
+- Added `timezone` option to client (default: `Europe/Paris`)
+- Removed `get_player` — endpoint now requires Cloudflare Turnstile (browser-only)
 
-## [0.0.1] - 2026-01-15
+## [0.1.0] - 2026-01-15
 
 ### Added
-- Initial release of modernized fotmob gem
-- Modern project structure with separate modules
-- Custom error classes (Error, APIError, NotFoundError, RateLimitError, TimeoutError, InvalidResponseError)
-- URI.open-based HTTP client with timeout support
-- Comprehensive error handling with proper HTTP status codes
-- YARD documentation for all public methods
-- RSpec test suite with VCR for API response recording
-- RuboCop linting with sensible defaults
-- GitHub Actions CI for automated testing
-- Gemfile and Rakefile for development workflow
-- Comprehensive README with examples and badges
-
-### Changed
-- Refactored from single-file to modular structure
-- Improved from basic API wrapper to production-ready gem
-- Switched to symbolized JSON keys for better Ruby idioms
-- Added timeout configuration support
-
-### API Methods
-- `get_team(team_id)` - Get team information and statistics
-- `get_match_details(match_id)` - Get detailed match information
-- `get_player(player_id)` - Get player profile and stats
-- `get_league(league_id)` - Get league standings and details
-- `get_matches(date)` - Get matches by date (limited availability)
-
-### Technical Details
-- Requires Ruby >= 2.7.0
-- Uses standard library only (no runtime dependencies)
-- Tested on Ruby 2.7, 3.0, 3.1, 3.2, 3.3
-- Bot protection handling via URI.open
-- Configurable timeout (default: 10 seconds)
-
-### Known Limitations
-- `get_matches` endpoint requires special authentication headers and may not work reliably
-- API is unofficial and may change without notice
+- Initial release
+- `get_team`, `get_match_details`, `get_player`, `get_league`, `get_matches`
+- Custom error classes, configurable timeout, VCR-based test suite
 
-[0.0.1]: https://github.com/bjrsti/fotmob/releases/tag/v0.0.1
+[0.1.0]: https://github.com/bjrsti/fotmob/releases/tag/v0.1.0

data/README.md

@@ -5,17 +5,16 @@
 [![Ruby](https://img.shields.io/badge/ruby-%3E%3D%202.7-ruby.svg)](https://www.ruby-lang.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-An unofficial Ruby wrapper for the [FotMob](https://www.fotmob.com/) API. Get football/soccer data including team stats, match details, player information, and league standings.
+An unofficial Ruby wrapper for the [FotMob](https://www.fotmob.com/) API. Get football/soccer data including team stats, match details, and league standings.
 
 ## Features
 
 - 🏆 **Team Data** - Get comprehensive team information and statistics
-- ⚽ **Match Details** - Detailed match information and live scores
-- 👤 **Player Stats** - Player profiles and performance data
-- 📊 **League Standings** - League tables and competition data
+- ⚽ **Match Details** - Detailed match information including lineups, stats, and live scores
+- 📅 **Matches by Date** - All matches for a given day across 150+ leagues
+- 📊 **League Data** - League tables, fixtures, and competition details
 - 🛡️ **Error Handling** - Custom error classes for different scenarios
-- ⏱️ **Timeout Support** - Configurable request timeouts
-- 📝 **Well Documented** - YARD documentation included
+- ⏱️ **Configurable** - Timeout and timezone support
 
 ## Installation
 
@@ -36,80 +35,70 @@ gem install fotmob
 ```ruby
 require 'fotmob'
 
-# Create a client
 client = Fotmob.new
 
-# Get team information
-team = client.get_team("8540") # Palermo
-puts team[:details][:name]
+# All matches for today
+matches = client.get_matches("20260516")
+matches[:leagues].each { |l| puts l[:name] }
 
-# Get match details
-match = client.get_match_details("4193741")
+# Match details (lineups, stats, events)
+match = client.get_match_details("5315746")
 puts "#{match[:general][:homeTeam][:name]} vs #{match[:general][:awayTeam][:name]}"
+puts match[:header][:status][:scoreStr]
 
-# Get player data
-player = client.get_player("961995") # Mbappé
-puts player[:name]
+# Team info
+team = client.get_team("8455") # Chelsea
+puts team[:details][:name]
 
-# Get league standings
+# League standings
 league = client.get_league("47") # Premier League
 puts league[:details][:name]
 ```
 
 ## API Methods
 
-### `get_team(team_id)`
+### `get_matches(date)`
 
-Get comprehensive team information.
+All matches for a given date (150+ leagues).
 
 ```ruby
-team = client.get_team("8540")
-# Returns: Hash with team details, fixtures, squad, etc.
+matches = client.get_matches("20260516")
+# Returns: { leagues: [...], date: "..." }
+# Each league has a :matches array with scores, teams, status
 ```
 
 ### `get_match_details(match_id)`
 
-Get detailed match information.
+Full match data — lineups, stats, events, shotmap.
 
 ```ruby
-match = client.get_match_details("4193741")
-# Returns: Hash with match details, lineups, events, stats
+match = client.get_match_details("5315746")
+# Returns: { general:, header:, content: { stats:, lineup:, shotmap:, ... } }
 ```
 
-### `get_player(player_id)`
+### `get_team(team_id)`
 
-Get player profile and statistics.
+Team overview, fixtures, and squad.
 
 ```ruby
-player = client.get_player("961995")
-# Returns: Hash with player info and stats
+team = client.get_team("8455")
+# Returns: { details:, overview:, fixtures:, ... }
 ```
 
 ### `get_league(league_id)`
 
-Get league/competition information.
+League table, fixtures, and stats.
 
 ```ruby
 league = client.get_league("47")
-# Returns: Hash with league details and standings
-```
-
-### `get_matches(date)` ⚠️
-
-**Note:** This endpoint currently requires special authentication headers and may not work reliably.
-
-```ruby
-matches = client.get_matches("20250114")
-# Returns: Hash with matches for the specified date
+# Returns: { details:, table:, fixtures:, stats:, ... }
 ```
 
 ## Configuration
 
-### Custom Timeout
-
 ```ruby
-# Default timeout is 10 seconds
-client = Fotmob.new(timeout: 30)
+# Defaults: timeout 10s, timezone Europe/Paris
+client = Fotmob.new(timeout: 30, timezone: "Europe/Paris")
 ```
 
 ## Error Handling
@@ -179,16 +168,11 @@ bundle exec rspec
 
 ## Finding IDs
 
-To use the API, you need IDs for teams, players, matches, and leagues:
+IDs are in the fotmob.com URL for each resource:
 
-- **Teams**: Visit [fotmob.com](https://www.fotmob.com/), search for a team, the ID is in the URL
-  - Example: `fotmob.com/teams/8540/overview/palermo` → Team ID: `8540`
-- **Players**: Search for a player, ID is in the URL
-  - Example: `fotmob.com/players/961995/kylian-mbappe` → Player ID: `961995`
-- **Matches**: Browse matches, ID is in the match URL
-  - Example: `fotmob.com/match/4193741` → Match ID: `4193741`
-- **Leagues**: Browse leagues, ID is in the league URL
-  - Example: `fotmob.com/leagues/47/overview/premier-league` → League ID: `47`
+- **Teams**: `fotmob.com/teams/8455/overview/chelsea` → `8455`
+- **Matches**: `fotmob.com/matches/chelsea-vs-manchester-city/abc123#5315746` → `5315746`
+- **Leagues**: `fotmob.com/leagues/47/overview/premier-league` → `47`
 
 ## Disclaimer
 

data/lib/fotmob/client.rb

@@ -6,73 +6,46 @@ require "uri"
 require "timeout"
 
 module Fotmob
-  # Main client for interacting with the FotMob API
   class Client
-    BASE_URL = "http://www.fotmob.com/api"
-    DEFAULT_TIMEOUT = 10 # seconds
+    BASE_URL = "https://www.fotmob.com/api/data"
+    DEFAULT_TIMEOUT = 10
+    DEFAULT_TIMEZONE = "Europe/Paris"
+    UA = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 " \
+         "(KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
 
-    attr_reader :timeout
+    attr_reader :timeout, :timezone
 
-    # Initialize a new FotMob API client
-    #
-    # @param timeout [Integer] Request timeout in seconds (default: 10)
-    def initialize(timeout: DEFAULT_TIMEOUT)
+    def initialize(timeout: DEFAULT_TIMEOUT, timezone: DEFAULT_TIMEZONE)
       @timeout = timeout
+      @timezone = timezone
     end
 
-    # Get league/competition data
-    #
-    # @param league_id [String] The league ID
-    # @return [Hash] League data with symbolized keys
-    # @raise [Fotmob::Error] If the request fails
     def get_league(league_id)
-      get("/leagues", id: league_id)
+      get("/leagues", id: league_id, tab: "overview")
     end
 
-    # Get matches for a specific date
-    #
-    # @param date [String] Date in YYYYMMDD format (e.g., "20221030")
-    # @return [Hash] Match data with symbolized keys
-    # @raise [Fotmob::Error] If the request fails
     def get_matches(date)
-      get("/matches", date: date)
+      get("/matches", date: date, timezone: @timezone)
     end
 
-    # Get detailed information about a specific match
-    #
-    # @param match_id [String] The match ID
-    # @return [Hash] Match details with symbolized keys
-    # @raise [Fotmob::Error] If the request fails
+    # Returns pageProps with keys: general, header, content (stats, lineup, etc.)
+    # Resolves the match slug via a redirect, with automatic buildId refresh on stale deploys.
     def get_match_details(match_id)
-      get("/matchDetails", matchId: match_id)
-    end
-
-    # Get player data and statistics
-    #
-    # @param player_id [String] The player ID
-    # @return [Hash] Player data with symbolized keys
-    # @raise [Fotmob::Error] If the request fails
-    def get_player(player_id)
-      get("/playerData", id: player_id)
+      @retried_build_id = false
+      build_id = fetch_build_id
+      slug = fetch_match_slug(match_id, build_id)
+      body = fetch_with_timeout(URI("https://www.fotmob.com/_next/data/#{build_id}/matches/#{slug}.json"))
+      parse_json(body)[:pageProps]
+    rescue OpenURI::HTTPError => e
+      handle_http_error(e)
     end
 
-    # Get team data and statistics
-    #
-    # @param team_id [String] The team ID
-    # @return [Hash] Team data with symbolized keys
-    # @raise [Fotmob::Error] If the request fails
     def get_team(team_id)
       get("/teams", id: team_id)
     end
 
     private
 
-    # Make a GET request to the FotMob API
-    #
-    # @param path [String] API endpoint path
-    # @param params [Hash] Query parameters
-    # @return [Hash] Parsed JSON response with symbolized keys
-    # @raise [Fotmob::Error] If the request fails
     def get(path, **params)
       uri = build_uri(path, params)
       response_body = fetch_with_timeout(uri)
@@ -81,30 +54,47 @@ module Fotmob
       handle_http_error(e)
     end
 
-    # Build URI with query parameters
+    def fetch_build_id(force: false)
+      @fetch_build_id = nil if force
+      @fetch_build_id ||= begin
+        html = fetch_with_timeout(URI("https://www.fotmob.com/"))
+        html.match(/"buildId":"([^"]+)"/)[1]
+      end
+    end
+
+    def fetch_match_slug(match_id, build_id)
+      redirect_body = fetch_with_timeout(
+        URI("https://www.fotmob.com/_next/data/#{build_id}/match/#{match_id}.json")
+      )
+      redirect = parse_json(redirect_body).dig(:pageProps, :__N_REDIRECT)
+      raise NotFoundError.new("Match #{match_id} not found", status_code: 404) unless redirect
+
+      redirect.sub(%r{^/matches/}, "").sub(/#.*$/, "")
+    rescue OpenURI::HTTPError => e
+      raise unless e.io.status[0].to_i == 404 && !@retried_build_id
+
+      @retried_build_id = true
+      fetch_match_slug(match_id, fetch_build_id(force: true))
+    end
+
     def build_uri(path, params)
-      # Use string concatenation like old version - URI.join doesn't work with /api/path
-      url = BASE_URL + path
-      uri = URI(url)
+      uri = URI(BASE_URL + path)
       uri.query = URI.encode_www_form(params) unless params.empty?
       uri
     end
 
-    # Fetch URL with timeout using URI.open (avoids bot detection)
     def fetch_with_timeout(uri)
       Timeout.timeout(@timeout) do
-        URI.open(uri.to_s).read
+        URI.open(uri.to_s, "User-Agent" => UA).read
       end
     rescue Timeout::Error => e
       raise TimeoutError, "Request timed out after #{@timeout} seconds: #{e.message}"
     rescue OpenURI::HTTPError
-      # Let HTTP errors bubble up to be handled by the caller
       raise
     rescue StandardError => e
       raise Error, "Network error: #{e.message}"
     end
 
-    # Handle HTTP errors from URI.open
     def handle_http_error(error)
       status = error.io.status[0].to_i
       body = begin
@@ -115,39 +105,18 @@ module Fotmob
 
       case status
       when 404
-        raise NotFoundError.new(
-          "Resource not found",
-          status_code: 404,
-          response_body: body
-        )
+        raise NotFoundError.new("Resource not found", status_code: 404, response_body: body)
       when 429
-        raise RateLimitError.new(
-          "Rate limit exceeded. Please try again later.",
-          status_code: 429,
-          response_body: body
-        )
+        raise RateLimitError.new("Rate limit exceeded. Please try again later.", status_code: 429, response_body: body)
       when 400..499
-        raise APIError.new(
-          "Client error: #{status}",
-          status_code: status,
-          response_body: body
-        )
+        raise APIError.new("Client error: #{status}", status_code: status, response_body: body)
       when 500..599
-        raise APIError.new(
-          "Server error: #{status}",
-          status_code: status,
-          response_body: body
-        )
+        raise APIError.new("Server error: #{status}", status_code: status, response_body: body)
       else
-        raise APIError.new(
-          "HTTP Error: #{status}",
-          status_code: status,
-          response_body: body
-        )
+        raise APIError.new("HTTP Error: #{status}", status_code: status, response_body: body)
       end
     end
 
-    # Parse JSON response with symbolized keys
     def parse_json(body)
       JSON.parse(body, symbolize_names: true)
     rescue JSON::ParserError => e

data/lib/fotmob/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fotmob
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fotmob
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Stian Bjørkelo
@@ -117,7 +117,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: An unofficial FotMob API wrapper for Ruby
 test_files: []