Skip to content

Custom API Configurations

David edited this page Nov 9, 2022 · 12 revisions

Custom API Configurations allow you to set up APIs for teams that play in leagues that are not natively supported by the Team Tracker integration. This is particularly useful for soccer, where ESPN has APIs that support over 100 international leagues.

Set league_idto XXX to indicate you are setting up a Custom API Configuration. You can set up a Custom API Configuration with the API or YAML.

The instructions below give more information on how to set up Custom API Configuration.

Determining the correct values for sport_path and league_path when setting up custom API configurations:

Although it may be outdated, the simplest way to determine valid values for sport_path and league_path to is to:

  1. Visit the ESPN API Explorer page.
  2. Click on the Score and Schedules API section to expand it.
  3. Select the desired sportName from the first drop down. Use this value in all lower case as your sport_path.
  4. Select the desired leagueName from the second drop down. Use this value in all lower case as your league_path.

The following custom API configurations are confirmed to have worked:

Fifa Friendlies

# Custom Integration - 
  - platform: teamtracker
    league_id: XXX
    team_id: USA
    sport_path: soccer
    league_path:  fifa.friendly
    name: test_tt_all_test19

Champions League

# Custom Integration - 
  - platform: teamtracker
    league_id: XXX
    team_id: BAR
    sport_path: soccer
    league_path:  uefa.champions
    name: test_tt_all_test20

The following custom API configurations do not work:

PGA

  - platform: teamtracker
    league_id: XXX
    team_id: McIlroy
    sport_path: golf
    league_path:  pga
    name: test_tt_all_teste04