fotmob 0.0.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5caec733f122382ab9f85603b76e3bbe504b30441006fd45cffda22fbe3ef7a
-  data.tar.gz: 03b13331563a2a684bae0f24c332969b83a6b2abbce004777747758fca0dcd59
+  metadata.gz: 2db5d9b53f38dd3532d6db31d0442b64193ee9df642f0e27e5cafca07e7ca5e7
+  data.tar.gz: ec6df784201636a0f4e5cb2585e022fb10ccad33e5de8dc8ba3311f6d0ef3f7d
 SHA512:
-  metadata.gz: a4568898b296b09d8984c40165568ea18cdbe0f60f54a0e4d5b1d01db6291f8962785128b24f40cc76553529b17a58a50ebf45e86aad7663cdcce6a827f6ab66
-  data.tar.gz: 4f6e2475ae2e1c029990de8d332b4eec869367adace09e315238452fee8427a81781eadc4a21d2513b6212807b44ebdb04753785c95a528590bc2254a7f04f2b
+  metadata.gz: ea85bde7a3e7f9ca2e3a124fe0613a1e2df76e29311557ba69065bb7968833d343c5e43afe887c260552095d602677335aac8a1f3a0a45b865d3f4ee9514afbc
+  data.tar.gz: 3dab6a921e4a4b40b28f3d434c2e099760b69c4d0d2d8d291e41131c2b9013da8656a7d992de9a24b8acbb63d1da6f333cba52e8a10560aa4e2e1af7144e147e

data/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+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.2.0] - 2026-05-16
+
+### Changed
+- 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.1.0] - 2026-01-15
+
+### Added
+- Initial release
+- `get_team`, `get_match_details`, `get_player`, `get_league`, `get_matches`
+- Custom error classes, configurable timeout, VCR-based test suite
+
+[0.1.0]: https://github.com/bjrsti/fotmob/releases/tag/v0.1.0

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stian Bjørkelo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,193 @@
+# Fotmob Ruby Gem
+
+[![Gem Version](https://badge.fury.io/rb/fotmob.svg)](https://badge.fury.io/rb/fotmob)
+[![CI](https://github.com/bjrsti/fotmob/actions/workflows/ci.yml/badge.svg)](https://github.com/bjrsti/fotmob/actions/workflows/ci.yml)
+[![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, and league standings.
+
+## Features
+
+- 🏆 **Team Data** - Get comprehensive team information and statistics
+- ⚽ **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
+- ⏱️ **Configurable** - Timeout and timezone support
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'fotmob'
+```
+
+Or install directly:
+
+```bash
+gem install fotmob
+```
+
+## Quick Start
+
+```ruby
+require 'fotmob'
+
+client = Fotmob.new
+
+# All matches for today
+matches = client.get_matches("20260516")
+matches[:leagues].each { |l| puts l[:name] }
+
+# 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]
+
+# Team info
+team = client.get_team("8455") # Chelsea
+puts team[:details][:name]
+
+# League standings
+league = client.get_league("47") # Premier League
+puts league[:details][:name]
+```
+
+## API Methods
+
+### `get_matches(date)`
+
+All matches for a given date (150+ leagues).
+
+```ruby
+matches = client.get_matches("20260516")
+# Returns: { leagues: [...], date: "..." }
+# Each league has a :matches array with scores, teams, status
+```
+
+### `get_match_details(match_id)`
+
+Full match data — lineups, stats, events, shotmap.
+
+```ruby
+match = client.get_match_details("5315746")
+# Returns: { general:, header:, content: { stats:, lineup:, shotmap:, ... } }
+```
+
+### `get_team(team_id)`
+
+Team overview, fixtures, and squad.
+
+```ruby
+team = client.get_team("8455")
+# Returns: { details:, overview:, fixtures:, ... }
+```
+
+### `get_league(league_id)`
+
+League table, fixtures, and stats.
+
+```ruby
+league = client.get_league("47")
+# Returns: { details:, table:, fixtures:, stats:, ... }
+```
+
+## Configuration
+
+```ruby
+# Defaults: timeout 10s, timezone Europe/Paris
+client = Fotmob.new(timeout: 30, timezone: "Europe/Paris")
+```
+
+## Error Handling
+
+The gem includes custom error classes for different scenarios:
+
+```ruby
+begin
+  team = client.get_team("invalid_id")
+rescue Fotmob::NotFoundError => e
+  puts "Team not found: #{e.message}"
+rescue Fotmob::RateLimitError => e
+  puts "Rate limit exceeded: #{e.message}"
+rescue Fotmob::TimeoutError => e
+  puts "Request timed out: #{e.message}"
+rescue Fotmob::APIError => e
+  puts "API error: #{e.message} (Status: #{e.status_code})"
+rescue Fotmob::Error => e
+  puts "Error: #{e.message}"
+end
+```
+
+### Error Classes
+
+- `Fotmob::Error` - Base error class
+- `Fotmob::APIError` - API returned an error response
+- `Fotmob::NotFoundError` - Resource not found (404)
+- `Fotmob::RateLimitError` - Rate limit exceeded (429)
+- `Fotmob::TimeoutError` - Request timed out
+- `Fotmob::InvalidResponseError` - Invalid JSON response
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/bjrsti/fotmob.git
+cd fotmob
+
+# Install dependencies
+bundle install
+
+# Run tests
+bundle exec rspec
+
+# Run linter
+bundle exec rubocop
+
+# Open console
+bundle exec rake console
+```
+
+## Testing
+
+The gem uses RSpec for testing with VCR for recording API responses:
+
+```bash
+bundle exec rspec
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a Pull Request
+
+## Finding IDs
+
+IDs are in the fotmob.com URL for each resource:
+
+- **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
+
+This is an unofficial API wrapper and is not affiliated with FotMob. Use at your own risk and be mindful of rate limits.
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+
+## Author
+
+[Stian Bjørkelo](https://github.com/bjrsti)
+
+## Links
+
+- [RubyGems](https://rubygems.org/gems/fotmob)
+- [GitHub](https://github.com/bjrsti/fotmob)
+- [Issues](https://github.com/bjrsti/fotmob/issues)

data/lib/fotmob/client.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+require "open-uri"
+require "json"
+require "uri"
+require "timeout"
+
+module Fotmob
+  class Client
+    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, :timezone
+
+    def initialize(timeout: DEFAULT_TIMEOUT, timezone: DEFAULT_TIMEZONE)
+      @timeout = timeout
+      @timezone = timezone
+    end
+
+    def get_league(league_id)
+      get("/leagues", id: league_id, tab: "overview")
+    end
+
+    def get_matches(date)
+      get("/matches", date: date, timezone: @timezone)
+    end
+
+    # 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)
+      @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
+
+    def get_team(team_id)
+      get("/teams", id: team_id)
+    end
+
+    private
+
+    def get(path, **params)
+      uri = build_uri(path, params)
+      response_body = fetch_with_timeout(uri)
+      parse_json(response_body)
+    rescue OpenURI::HTTPError => e
+      handle_http_error(e)
+    end
+
+    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)
+      uri = URI(BASE_URL + path)
+      uri.query = URI.encode_www_form(params) unless params.empty?
+      uri
+    end
+
+    def fetch_with_timeout(uri)
+      Timeout.timeout(@timeout) do
+        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
+      raise
+    rescue StandardError => e
+      raise Error, "Network error: #{e.message}"
+    end
+
+    def handle_http_error(error)
+      status = error.io.status[0].to_i
+      body = begin
+        error.io.read
+      rescue StandardError
+        ""
+      end
+
+      case status
+      when 404
+        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)
+      when 400..499
+        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)
+      else
+        raise APIError.new("HTTP Error: #{status}", status_code: status, response_body: body)
+      end
+    end
+
+    def parse_json(body)
+      JSON.parse(body, symbolize_names: true)
+    rescue JSON::ParserError => e
+      raise InvalidResponseError, "Failed to parse response: #{e.message}"
+    end
+  end
+end

data/lib/fotmob/error.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Fotmob
+  # Base error class for all Fotmob errors
+  class Error < StandardError; end
+
+  # Raised when the API returns an error response
+  class APIError < Error
+    attr_reader :status_code, :response_body
+
+    def initialize(message, status_code: nil, response_body: nil)
+      @status_code = status_code
+      @response_body = response_body
+      super(message)
+    end
+  end
+
+  # Raised when a resource is not found (404)
+  class NotFoundError < APIError; end
+
+  # Raised when rate limit is exceeded (429)
+  class RateLimitError < APIError; end
+
+  # Raised when the request times out
+  class TimeoutError < Error; end
+
+  # Raised when the response cannot be parsed or is invalid
+  class InvalidResponseError < Error; end
+end

data/lib/fotmob/version.rb

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

data/lib/fotmob.rb

@@ -1,45 +1,18 @@
-require 'open-uri'
-require 'json'
+# frozen_string_literal: true
 
-class Fotmob
-  
-  BASE_URL          = "http://www.fotmob.com/api"
-  LEAGUES_URL       = BASE_URL + "/leagues?id="
-  MATCHES_URL       = BASE_URL + "/matches?date="
-  MATCH_DETAILS_URL = BASE_URL + "/matchDetails?matchId="
-  PLAYER_URL        = BASE_URL + "/playerData?id="
-  TEAMS_URL         = BASE_URL + "/teams?id="
-  
-  def get_league(league_id)
-    json = URI.open(LEAGUES_URL+league_id).read
-    symbolize_json(json)
-  end
-  
-  def get_matches(match_date)
-    json = URI.open(MATCHES_URL+match_date).read
-    symbolize_json(json)
-  end
-  
-  def get_match_details(match_id)
-    json = URI.open(MATCH_DETAILS_URL+match_id).read
-    symbolize_json(json)
-  end
-  
-  def get_player(player_id)
-    json = URI.open(PLAYER_URL+player_id).read
-    symbolize_json(json)
-  end
-  
-  def get_team(team_id)
-    json = URI.open(TEAMS_URL+team_id).read
-    symbolize_json(json)
-  end
-  
-  
-  private
-  
-  def symbolize_json(json)
-    JSON.parse(json, :symbolize_names => true)
+require_relative "fotmob/version"
+require_relative "fotmob/error"
+require_relative "fotmob/client"
+
+# FotMob API wrapper for Ruby
+module Fotmob
+  class << self
+    # Create a new client instance
+    #
+    # @param options [Hash] Client options
+    # @return [Fotmob::Client] A new client instance
+    def new(**options)
+      Client.new(**options)
+    end
   end
-  
-end
+end

metadata

@@ -1,67 +1,108 @@
 --- !ruby/object:Gem::Specification
 name: fotmob
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Stian Bjørkelo
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-10-30 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: open-uri
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.2.0
-  type: :runtime
+        version: '13.0'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
-    - - ">="
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
 - !ruby/object:Gem::Dependency
-  name: json
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
-    - - ">="
+        version: '1.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.6.2
-  type: :runtime
+        version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
-    - - ">="
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.6.2
-description: Lets you pull data from fotmob for easy access
+        version: '3.18'
+description: A simple Ruby gem for accessing football/soccer data from the FotMob
+  API. Get team stats, match details, player data, league tables, and more.
 email: stianbj@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
+- LICENSE
+- README.md
 - lib/fotmob.rb
+- lib/fotmob/client.rb
+- lib/fotmob/error.rb
+- lib/fotmob/version.rb
 homepage: https://github.com/bjrsti/fotmob
 licenses:
 - MIT
-metadata: {}
-post_install_message:
+metadata:
+  homepage_uri: https://github.com/bjrsti/fotmob
+  source_code_uri: https://github.com/bjrsti/fotmob
+  bug_tracker_uri: https://github.com/bjrsti/fotmob/issues
+  changelog_uri: https://github.com/bjrsti/fotmob/blob/main/CHANGELOG.md
+  documentation_uri: https://github.com/bjrsti/fotmob#readme
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -69,15 +110,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.24
-signing_key:
+rubygems_version: 4.0.6
 specification_version: 4
-summary: An unofficial Fotmob API wrapper for Ruby
+summary: An unofficial FotMob API wrapper for Ruby
 test_files: []