impectPy 2.5.8__tar.gz → 2.5.10__tar.gz

{impectpy-2.5.8 → impectpy-2.5.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: impectPy
-Version: 2.5.8
+Version: 2.5.10
 Summary: A Python package to facilitate interaction with the Impect customer API
 Home-page: https://github.com/ImpectAPI/impectPy
 Author: Impect
@@ -25,9 +25,9 @@ Dynamic: summary
 
 A package provided by: Impect GmbH
 
-Version: v2.5.8
+Version: v2.5.10
 
-**Updated: March 19th 2026**
+**Updated: April 13th 2026**
 
 ---
 
@@ -58,7 +58,7 @@ pip install impectPy
 You can also install it from [GitHub](https://github.com/) with:
 
 ```cmd
-pip install git+https://github.com/ImpectAPI/impectPy.git@v2.5.8
+pip install git+https://github.com/ImpectAPI/impectPy.git@v2.5.10
 ```
 
 ## Usage
@@ -302,6 +302,15 @@ calls made on the client side already. The rate limit is read from the first lim
 policy sent back by the API, so if this limit increases over time, this package will
 act accordingly.
 
+### Generic API Call
+You can also use this package to make individual API calls querying a specific endpoint 
+such as the "squads" endpoint.
+
+```python
+# query any IMPECT customer API endpoint
+data = ip.getData(url=f"https://api.impect.com/v5/customerapi/iterations/{iteration}/squads", token=token)
+```
+
 ### SportsCodeXML
 
 It is also possible to convert a dataframe containing event data into an XML file,
@@ -449,6 +458,9 @@ squadIterationScores = api.getSquadIterationScores(iteration=iteration)
 
 # get player profile scores
 playerProfileScores = api.getPlayerProfileScores(iteration=iteration, positions=positions)
+
+# query single API endpoint (e.g. squads for iteration 518)
+data = api.getData(url=f"https://api.impect.com/v5/customerapi/iterations/{iteration}/squads")
 ```
 
 ## Final Notes

{impectpy-2.5.8 → impectpy-2.5.10}/README.md

@@ -2,9 +2,9 @@
 
 A package provided by: Impect GmbH
 
-Version: v2.5.8
+Version: v2.5.10
 
-**Updated: March 19th 2026**
+**Updated: April 13th 2026**
 
 ---
 
@@ -35,7 +35,7 @@ pip install impectPy
 You can also install it from [GitHub](https://github.com/) with:
 
 ```cmd
-pip install git+https://github.com/ImpectAPI/impectPy.git@v2.5.8
+pip install git+https://github.com/ImpectAPI/impectPy.git@v2.5.10
 ```
 
 ## Usage
@@ -279,6 +279,15 @@ calls made on the client side already. The rate limit is read from the first lim
 policy sent back by the API, so if this limit increases over time, this package will
 act accordingly.
 
+### Generic API Call
+You can also use this package to make individual API calls querying a specific endpoint 
+such as the "squads" endpoint.
+
+```python
+# query any IMPECT customer API endpoint
+data = ip.getData(url=f"https://api.impect.com/v5/customerapi/iterations/{iteration}/squads", token=token)
+```
+
 ### SportsCodeXML
 
 It is also possible to convert a dataframe containing event data into an XML file,
@@ -426,6 +435,9 @@ squadIterationScores = api.getSquadIterationScores(iteration=iteration)
 
 # get player profile scores
 playerProfileScores = api.getPlayerProfileScores(iteration=iteration, positions=positions)
+
+# query single API endpoint (e.g. squads for iteration 518)
+data = api.getData(url=f"https://api.impect.com/v5/customerapi/iterations/{iteration}/squads")
 ```
 
 ## Final Notes

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/__init__.py

@@ -1,5 +1,5 @@
 # define version attribute
-__version__ = "2.5.8"
+__version__ = "2.5.10"
 
 # import modules
 from .access_token import getAccessToken
@@ -22,5 +22,6 @@ from .squad_coefficients import getSquadCoefficients
 from .formations import getFormations
 from .substitutions import getSubstitutions
 from .starting_positions import getStartingPositions
+from .data import getData
 from .config import Config as Config
 from .impect import Impect as Impect

impectpy-2.5.10/impectPy/data.py

@@ -0,0 +1,54 @@
+# load packages
+import pandas as pd
+from typing import Optional, Dict, Any
+from impectPy.helpers import RateLimitedAPI, ImpectSession
+
+
+######
+#
+# This function returns a dataframe from any Impect API endpoint
+#
+######
+
+
+def getData(
+        url: str, token: str, method: str = "GET", data: Optional[Dict[str, Any]] = None,
+        session: Optional[ImpectSession] = None
+) -> pd.DataFrame:
+    """Returns a processed DataFrame from any Impect API endpoint.
+
+    Args:
+        url (str): Full URL of the API endpoint.
+        token (str): Bearer token for authentication.
+        method (str): HTTP method. Defaults to "GET".
+        data (Optional[Dict[str, Any]]): Optional request body. Defaults to None.
+        session (Optional[ImpectSession]): The session object to use for the API calls. Defaults to a new ImpectSession.
+
+    Returns:
+        pd.DataFrame: Processed response data.
+    """
+    # create an instance of RateLimitedAPI
+    connection = RateLimitedAPI(session or ImpectSession())
+
+    # set auth header
+    connection.session.headers.update({"Authorization": f"Bearer {token}"})
+
+    return getDataFromHost(url=url, method=method, connection=connection, data=data)
+
+
+def getDataFromHost(
+        url: str, method: str, connection: RateLimitedAPI, data: Optional[Dict[str, Any]] = None
+) -> pd.DataFrame:
+    """Core implementation: executes a rate-limited API call and returns a processed DataFrame.
+
+    Args:
+        url (str): Full URL of the API endpoint.
+        method (str): HTTP method.
+        connection (RateLimitedAPI): Authenticated connection object.
+        data (Optional[Dict[str, Any]]): Optional request body. Defaults to None.
+
+    Returns:
+        pd.DataFrame: Processed response data.
+    """
+    response = connection.make_api_request_limited(url=url, method=method, data=data)
+    return response.process_response(endpoint=url)

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/formations.py

@@ -134,7 +134,7 @@ def getFormationsFromHost(matches: list, connection: RateLimitedAPI, host: str)
     # merge with matches info
     formations = formations.merge(
         matchplan[[
-            "id", "skillCornerId", "heimSpielId", "wyscoutId", "matchDayIndex",
+            "id", "skillCornerId", "heimSpielId", "wyscoutId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "matchDayIndex",
             "matchDayName", "scheduledDate", "lastCalculationDate", "iterationId"
         ]],
         left_on="id",

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/helpers.py

@@ -278,7 +278,7 @@ def unnest_mappings_dict(mapping_dict: dict) -> dict:
 
 def unnest_mappings_df(df: pd.DataFrame, mapping_col: str) -> pd.DataFrame:
     # create empty df to store mappings
-    df_mappings = pd.DataFrame(columns=["wyscoutId", "heimSpielId", "skillCornerId"])
+    df_mappings = pd.DataFrame(columns=["wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId"])
 
     # iterate over entry and unnest idMappings
     for index, entry in df.iterrows():
@@ -291,7 +291,9 @@ def unnest_mappings_df(df: pd.DataFrame, mapping_col: str) -> pd.DataFrame:
                     provider = "heimSpiel"
                 elif provider == "skill_corner":
                     provider = "skillCorner"
-                elif provider == "wyscout":
+                elif provider == "stats_perform":
+                    provider = "statsPerform"
+                elif provider in ("wyscout", "opta", "transfermarkt", "soccerdonna"):
                     pass
                 else:
                     raise Exception(f"Unknown provider: {provider}")

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/impect.py

@@ -1,4 +1,10 @@
+from typing import Optional, Dict, Any
+from xml.etree import ElementTree as ET
+
+import pandas as pd
+
 from impectPy.config import Config
+
 from .helpers import RateLimitedAPI
 from .access_token import getAccessTokenFromUrl
 from .iterations import getIterationsFromHost
@@ -20,8 +26,7 @@ from .squad_coefficients import getSquadCoefficientsFromHost
 from .formations import getFormationsFromHost
 from .substitutions import getSubstitutionsFromHost
 from .starting_positions import getStartingPositionsFromHost
-import pandas as pd
-from xml.etree import ElementTree as ET
+from .data import getDataFromHost
 
 
 class Impect:
@@ -130,6 +135,26 @@ class Impect:
             matches, self.connection, self.__config.HOST
         )
 
+    def getData(
+            self, url: str, method: str = "GET", data: Optional[Dict[str, Any]] = None
+    ) -> pd.DataFrame:
+        """Returns a processed DataFrame from any Impect API endpoint.
+
+        Accepts a full URL or a path. If a path is provided (does not start
+        with 'http'), the configured host is prepended automatically.
+
+        Args:
+            url (str): Full URL or path of the API endpoint.
+            method (str): HTTP method. Defaults to "GET".
+            data (Optional[Dict[str, Any]]): Optional request body. Defaults to None.
+
+        Returns:
+            pd.DataFrame: Processed response data.
+        """
+        if not url.startswith("http"):
+            url = f"{self.__config.HOST}{url}"
+        return getDataFromHost(url=url, method=method, connection=self.connection, data=data)
+
     @staticmethod
     def generateXML(
             events: pd.DataFrame,

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/iterations.py

@@ -49,6 +49,10 @@ def getIterationsFromHost(connection: RateLimitedAPI, host: str) -> pd.DataFrame
     df.skillCornerId = df.skillCornerId.apply(lambda x: x[0] if x else None)
     df.heimSpielId = df.heimSpielId.apply(lambda x: x[0] if x else None)
     df.wyscoutId = df.wyscoutId.apply(lambda x: x[0] if x else None)
+    df.optaId = df.optaId.apply(lambda x: x[0] if x else None)
+    df.statsPerformId = df.statsPerformId.apply(lambda x: x[0] if x else None)
+    df.transfermarktId = df.transfermarktId.apply(lambda x: x[0] if x else None)
+    df.soccerdonnaId = df.soccerdonnaId.apply(lambda x: x[0] if x else None)
 
     # get country data
     countries = connection.make_api_request_limited(
@@ -84,6 +88,10 @@ def getIterationsFromHost(connection: RateLimitedAPI, host: str) -> pd.DataFrame
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
     ]
 
     # select columns

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/matches.py

@@ -69,6 +69,10 @@ def getMatchesFromHost(iteration: int, connection: RateLimitedAPI, host: str) ->
         "skillCornerId_home": "homeSquadSkillCornerId",
         "heimSpielId_home": "homeSquadHeimSpielId",
         "wyscoutId_home": "homeSquadWyscoutId",
+        "optaId_home": "homeSquadOptaId",
+        "statsPerformId_home": "homeSquadStatsPerformId",
+        "transfermarktId_home": "homeSquadTransfermarktId",
+        "soccerdonnaId_home": "homeSquadSoccerdonnaId",
         "countryId": "homeSquadCountryId"
     })
     matches = matches.merge(squads,
@@ -81,6 +85,10 @@ def getMatchesFromHost(iteration: int, connection: RateLimitedAPI, host: str) ->
         "skillCornerId_away": "awaySquadSkillCornerId",
         "heimSpielId_away": "awaySquadHeimSpielId",
         "wyscoutId_away": "awaySquadWyscoutId",
+        "optaId_away": "awaySquadOptaId",
+        "statsPerformId_away": "awaySquadStatsPerformId",
+        "transfermarktId_away": "awaySquadTransfermarktId",
+        "soccerdonnaId_away": "awaySquadSoccerdonnaId",
         "countryId": "awaySquadCountryId"
     })
 
@@ -107,6 +115,10 @@ def getMatchesFromHost(iteration: int, connection: RateLimitedAPI, host: str) ->
         "skillCornerId",
         "heimSpielId",
         "wyscoutId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "iterationId",
         "matchDayIndex",
         "matchDayName",
@@ -118,6 +130,10 @@ def getMatchesFromHost(iteration: int, connection: RateLimitedAPI, host: str) ->
         "homeSquadSkillCornerId",
         "homeSquadHeimSpielId",
         "homeSquadWyscoutId",
+        "homeSquadOptaId",
+        "homeSquadStatsPerformId",
+        "homeSquadTransfermarktId",
+        "homeSquadSoccerdonnaId",
         "awaySquadId",
         "awaySquadName",
         "awaySquadType",
@@ -126,6 +142,10 @@ def getMatchesFromHost(iteration: int, connection: RateLimitedAPI, host: str) ->
         "awaySquadSkillCornerId",
         "awaySquadHeimSpielId",
         "awaySquadWyscoutId",
+        "awaySquadOptaId",
+        "awaySquadStatsPerformId",
+        "awaySquadTransfermarktId",
+        "awaySquadSoccerdonnaId",
         "scheduledDate",
         "lastCalculationDate",
         "available"
@@ -156,9 +176,13 @@ def clean_df(data: dict) -> pd.DataFrame:
     # drop idMappings column
     df = df.drop("idMappings", axis=1)
 
-    # keep first entry for skillcorner and heimspiel data
+    # keep first entry for skillcorner, heimspiel, wyscout, opta, statsperform, transfermarkt and soccerdonna data
     df.skillCornerId = df.skillCornerId.apply(lambda x: x[0] if x else None)
     df.heimSpielId = df.heimSpielId.apply(lambda x: x[0] if x else None)
     df.wyscoutId = df.wyscoutId.apply(lambda x: x[0] if x else None)
+    df.optaId = df.optaId.apply(lambda x: x[0] if x else None)
+    df.statsPerformId = df.statsPerformId.apply(lambda x: x[0] if x else None)
+    df.transfermarktId = df.transfermarktId.apply(lambda x: x[0] if x else None)
+    df.soccerdonnaId = df.soccerdonnaId.apply(lambda x: x[0] if x else None)
 
     return df

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/player_iteration_averages.py

@@ -198,7 +198,7 @@ def getPlayerIterationAveragesFromHost(
         suffixes=("", "_squads")
     ).merge(
         players[[
-            "id", "wyscoutId", "heimSpielId", "skillCornerId", "commonname",
+            "id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "commonname",
             "firstname", "lastname", "birthdate", "birthplace", "countryId", "leg"
         ]].rename(
             columns={"commonname": "playerName"}
@@ -225,6 +225,10 @@ def getPlayerIterationAveragesFromHost(
     averages["wyscoutId"] = averages["wyscoutId"].astype("Int64")
     averages["heimSpielId"] = averages["heimSpielId"].astype("Int64")
     averages["skillCornerId"] = averages["skillCornerId"].astype("Int64")
+    averages["optaId"] = averages["optaId"].astype("string")
+    averages["statsPerformId"] = averages["statsPerformId"].astype("string")
+    averages["transfermarktId"] = averages["transfermarktId"].astype("string")
+    averages["soccerdonnaId"] = averages["soccerdonnaId"].astype("string")
 
     # define column order
     order = [
@@ -237,6 +241,10 @@ def getPlayerIterationAveragesFromHost(
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "playerName",
         "firstname",
         "lastname",

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/player_iteration_scores.py

@@ -271,7 +271,7 @@ def getPlayerIterationScoresFromHost(
         suffixes=("", "_iterations")
     ).merge(
         players[[
-            "id", "wyscoutId", "heimSpielId", "skillCornerId", "commonname",
+            "id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "commonname",
             "firstname", "lastname", "birthdate", "birthplace", "countryId", "leg"
         ]].rename(
             columns={"commonname": "playerName"}
@@ -302,6 +302,10 @@ def getPlayerIterationScoresFromHost(
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "playerName",
         "firstname",
         "lastname",
@@ -326,6 +330,10 @@ def getPlayerIterationScoresFromHost(
     averages["wyscoutId"] = averages["wyscoutId"].astype("Int64")
     averages["heimSpielId"] = averages["heimSpielId"].astype("Int64")
     averages["skillCornerId"] = averages["skillCornerId"].astype("Int64")
+    averages["optaId"] = averages["optaId"].astype("string")
+    averages["statsPerformId"] = averages["statsPerformId"].astype("string")
+    averages["transfermarktId"] = averages["transfermarktId"].astype("string")
+    averages["soccerdonnaId"] = averages["soccerdonnaId"].astype("string")
 
     # return result
     return averages

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/player_match_scores.py

@@ -378,7 +378,7 @@ def getPlayerMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host
         suffixes=("", "_iterations")
     ).merge(
         players[[
-            "id", "wyscoutId", "heimSpielId", "skillCornerId", "commonname",
+            "id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "commonname",
             "firstname", "lastname", "birthdate", "birthplace", "countryId", "leg"
         ]].rename(
             columns={"commonname": "playerName"}
@@ -424,6 +424,10 @@ def getPlayerMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "playerName",
         "firstname",
         "lastname",
@@ -453,6 +457,10 @@ def getPlayerMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host
     player_scores["wyscoutId"] = player_scores["wyscoutId"].astype("Int64")
     player_scores["heimSpielId"] = player_scores["heimSpielId"].astype("Int64")
     player_scores["skillCornerId"] = player_scores["skillCornerId"].astype("Int64")
+    player_scores["optaId"] = player_scores["optaId"].astype("string")
+    player_scores["statsPerformId"] = player_scores["statsPerformId"].astype("string")
+    player_scores["transfermarktId"] = player_scores["transfermarktId"].astype("string")
+    player_scores["soccerdonnaId"] = player_scores["soccerdonnaId"].astype("string")
 
     # return data
     return player_scores

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/player_matchsums.py

@@ -272,7 +272,7 @@ def getPlayerMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host:
         suffixes=("", "_iterations")
     ).merge(
         players[[
-            "id", "wyscoutId", "heimSpielId", "skillCornerId", "commonname",
+            "id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "commonname",
             "firstname", "lastname", "birthdate", "birthplace", "countryId", "leg"
         ]].rename(
             columns={"commonname": "playerName"}
@@ -318,6 +318,10 @@ def getPlayerMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host:
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "playerName",
         "firstname",
         "lastname",
@@ -347,6 +351,10 @@ def getPlayerMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host:
     matchsums["wyscoutId"] = matchsums["wyscoutId"].astype("Int64")
     matchsums["heimSpielId"] = matchsums["heimSpielId"].astype("Int64")
     matchsums["skillCornerId"] = matchsums["skillCornerId"].astype("Int64")
+    matchsums["optaId"] = matchsums["optaId"].astype("string")
+    matchsums["statsPerformId"] = matchsums["statsPerformId"].astype("string")
+    matchsums["transfermarktId"] = matchsums["transfermarktId"].astype("string")
+    matchsums["soccerdonnaId"] = matchsums["soccerdonnaId"].astype("string")
 
     # return data
     return matchsums

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/player_profile_scores.py

@@ -211,7 +211,7 @@ def getPlayerProfileScoresFromHost(
         suffixes=("", "_squads")
     ).merge(
         players[[
-            "id", "wyscoutId", "heimSpielId", "skillCornerId", "commonname",
+            "id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "commonname",
             "firstname", "lastname", "birthdate", "birthplace", "countryId", "leg"
         ]].rename(
             columns={"commonname": "playerName"}
@@ -233,6 +233,10 @@ def getPlayerProfileScoresFromHost(
     profile_scores["wyscoutId"] = profile_scores["wyscoutId"].astype("Int64")
     profile_scores["heimSpielId"] = profile_scores["heimSpielId"].astype("Int64")
     profile_scores["skillCornerId"] = profile_scores["skillCornerId"].astype("Int64")
+    profile_scores["optaId"] = profile_scores["optaId"].astype("string")
+    profile_scores["statsPerformId"] = profile_scores["statsPerformId"].astype("string")
+    profile_scores["transfermarktId"] = profile_scores["transfermarktId"].astype("string")
+    profile_scores["soccerdonnaId"] = profile_scores["soccerdonnaId"].astype("string")
 
     # define column order
     order = [
@@ -245,6 +249,10 @@ def getPlayerProfileScoresFromHost(
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "playerName",
         "firstname",
         "lastname",

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/squad_coefficients.py

@@ -87,7 +87,7 @@ def getSquadCoefficientsFromHost(iteration: int, connection: RateLimitedAPI, hos
 
     # merge events with squads
     coefficients = coefficients.merge(
-        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "name"]].rename(
+        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "name"]].rename(
             columns={"id": "squadId", "name": "squadName"}
         ),
         left_on="squadId",
@@ -103,6 +103,10 @@ def getSquadCoefficientsFromHost(iteration: int, connection: RateLimitedAPI, hos
     coefficients["wyscoutId"] = coefficients["wyscoutId"].astype("Int64")
     coefficients["heimSpielId"] = coefficients["heimSpielId"].astype("Int64")
     coefficients["skillCornerId"] = coefficients["skillCornerId"].astype("Int64")
+    coefficients["optaId"] = coefficients["optaId"].astype("string")
+    coefficients["statsPerformId"] = coefficients["statsPerformId"].astype("string")
+    coefficients["transfermarktId"] = coefficients["transfermarktId"].astype("string")
+    coefficients["soccerdonnaId"] = coefficients["soccerdonnaId"].astype("string")
 
     # define desired column order
     order = [
@@ -120,6 +124,10 @@ def getSquadCoefficientsFromHost(iteration: int, connection: RateLimitedAPI, hos
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "squadName",
         "attackCoefficient",
         "defenseCoefficient",

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/squad_iteration_averages.py

@@ -110,7 +110,7 @@ def getSquadIterationAveragesFromHost(iteration: int, connection: RateLimitedAPI
         how="left",
         suffixes=("", "_iterations")
     ).merge(
-        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "name"]].rename(
+        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "name"]].rename(
             columns={"id": "squadId", "name": "squadName"}
         ),
         left_on="squadId",
@@ -129,6 +129,10 @@ def getSquadIterationAveragesFromHost(iteration: int, connection: RateLimitedAPI
     averages["wyscoutId"] = averages["wyscoutId"].astype("Int64")
     averages["heimSpielId"] = averages["heimSpielId"].astype("Int64")
     averages["skillCornerId"] = averages["skillCornerId"].astype("Int64")
+    averages["optaId"] = averages["optaId"].astype("string")
+    averages["statsPerformId"] = averages["statsPerformId"].astype("string")
+    averages["transfermarktId"] = averages["transfermarktId"].astype("string")
+    averages["soccerdonnaId"] = averages["soccerdonnaId"].astype("string")
 
     # define column order
     order = [
@@ -139,6 +143,10 @@ def getSquadIterationAveragesFromHost(iteration: int, connection: RateLimitedAPI
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "squadName",
         "matches"
     ]

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/squad_iteration_scores.py

@@ -110,7 +110,7 @@ def getSquadIterationScoresFromHost(iteration: int, connection: RateLimitedAPI,
         how="left",
         suffixes=("", "_iterations")
     ).merge(
-        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "name"]].rename(
+        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "name"]].rename(
             columns={"id": "squadId", "name": "squadName"}
         ),
         left_on="squadId",
@@ -129,6 +129,10 @@ def getSquadIterationScoresFromHost(iteration: int, connection: RateLimitedAPI,
     averages["wyscoutId"] = averages["wyscoutId"].astype("Int64")
     averages["heimSpielId"] = averages["heimSpielId"].astype("Int64")
     averages["skillCornerId"] = averages["skillCornerId"].astype("Int64")
+    averages["optaId"] = averages["optaId"].astype("string")
+    averages["statsPerformId"] = averages["statsPerformId"].astype("string")
+    averages["transfermarktId"] = averages["transfermarktId"].astype("string")
+    averages["soccerdonnaId"] = averages["soccerdonnaId"].astype("string")
 
     # define column order
     order = [
@@ -139,6 +143,10 @@ def getSquadIterationScoresFromHost(iteration: int, connection: RateLimitedAPI,
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "squadName",
         "matches"
     ]

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/squad_match_scores.py

@@ -221,7 +221,7 @@ def getSquadMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host:
         how="left",
         suffixes=("", "_iterations")
     ).merge(
-        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "name"]].rename(
+        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "name"]].rename(
             columns={"id": "squadId", "name": "squadName"}
         ),
         left_on="squadId",
@@ -259,6 +259,10 @@ def getSquadMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host:
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "squadName",
         "coachId",
         "coachName"
@@ -283,6 +287,10 @@ def getSquadMatchScoresFromHost(matches: list, connection: RateLimitedAPI, host:
     squad_scores["wyscoutId"] = squad_scores["wyscoutId"].astype("Int64")
     squad_scores["heimSpielId"] = squad_scores["heimSpielId"].astype("Int64")
     squad_scores["skillCornerId"] = squad_scores["skillCornerId"].astype("Int64")
+    squad_scores["optaId"] = squad_scores["optaId"].astype("string")
+    squad_scores["statsPerformId"] = squad_scores["statsPerformId"].astype("string")
+    squad_scores["transfermarktId"] = squad_scores["transfermarktId"].astype("string")
+    squad_scores["soccerdonnaId"] = squad_scores["soccerdonnaId"].astype("string")
 
     # return data
     return squad_scores

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/squad_matchsums.py

@@ -221,7 +221,7 @@ def getSquadMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host: s
         how="left",
         suffixes=("", "_iterations")
     ).merge(
-        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "name"]].rename(
+        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "name"]].rename(
             columns={"id": "squadId", "name": "squadName"}
         ),
         left_on="squadId",
@@ -259,6 +259,10 @@ def getSquadMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host: s
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "squadName",
         "coachId",
         "coachName"
@@ -292,6 +296,10 @@ def getSquadMatchsumsFromHost(matches: list, connection: RateLimitedAPI, host: s
     matchsums["wyscoutId"] = matchsums["wyscoutId"].astype("Int64")
     matchsums["heimSpielId"] = matchsums["heimSpielId"].astype("Int64")
     matchsums["skillCornerId"] = matchsums["skillCornerId"].astype("Int64")
+    matchsums["optaId"] = matchsums["optaId"].astype("string")
+    matchsums["statsPerformId"] = matchsums["statsPerformId"].astype("string")
+    matchsums["transfermarktId"] = matchsums["transfermarktId"].astype("string")
+    matchsums["soccerdonnaId"] = matchsums["soccerdonnaId"].astype("string")
 
     # return data
     return matchsums

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/squad_ratings.py

@@ -85,7 +85,7 @@ def getSquadRatingsFromHost(iteration: int, connection: RateLimitedAPI, host: st
 
     # merge events with squads
     ratings = ratings.merge(
-        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "name"]].rename(
+        squads[["id", "wyscoutId", "heimSpielId", "skillCornerId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "name"]].rename(
             columns={"id": "squadId", "name": "squadName"}
         ),
         left_on="squadId",
@@ -101,6 +101,10 @@ def getSquadRatingsFromHost(iteration: int, connection: RateLimitedAPI, host: st
     ratings["wyscoutId"] = ratings["wyscoutId"].astype("Int64")
     ratings["heimSpielId"] = ratings["heimSpielId"].astype("Int64")
     ratings["skillCornerId"] = ratings["skillCornerId"].astype("Int64")
+    ratings["optaId"] = ratings["optaId"].astype("string")
+    ratings["statsPerformId"] = ratings["statsPerformId"].astype("string")
+    ratings["transfermarktId"] = ratings["transfermarktId"].astype("string")
+    ratings["soccerdonnaId"] = ratings["soccerdonnaId"].astype("string")
 
     # define desired column order
     order = [
@@ -115,6 +119,10 @@ def getSquadRatingsFromHost(iteration: int, connection: RateLimitedAPI, host: st
         "wyscoutId",
         "heimSpielId",
         "skillCornerId",
+        "optaId",
+        "statsPerformId",
+        "transfermarktId",
+        "soccerdonnaId",
         "squadName",
         "value"
     ]

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/starting_positions.py

@@ -179,7 +179,7 @@ def getStartingPositionsFromHost(matches: list, connection: RateLimitedAPI, host
     # merge with matches info
     starting_positions = starting_positions.merge(
         matchplan[[
-            "id", "skillCornerId", "heimSpielId", "wyscoutId", "matchDayIndex",
+            "id", "skillCornerId", "heimSpielId", "wyscoutId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "matchDayIndex",
             "matchDayName", "scheduledDate", "lastCalculationDate", "iterationId"
         ]],
         left_on="id",

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy/substitutions.py

@@ -194,7 +194,7 @@ def getSubstitutionsFromHost(matches: list, connection: RateLimitedAPI, host: st
     # merge with matches info
     substitutions = substitutions.merge(
         matchplan[[
-            "id", "skillCornerId", "heimSpielId", "wyscoutId", "matchDayIndex",
+            "id", "skillCornerId", "heimSpielId", "wyscoutId", "optaId", "statsPerformId", "transfermarktId", "soccerdonnaId", "matchDayIndex",
             "matchDayName", "scheduledDate", "lastCalculationDate", "iterationId"
         ]],
         left_on="id",

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: impectPy
-Version: 2.5.8
+Version: 2.5.10
 Summary: A Python package to facilitate interaction with the Impect customer API
 Home-page: https://github.com/ImpectAPI/impectPy
 Author: Impect
@@ -25,9 +25,9 @@ Dynamic: summary
 
 A package provided by: Impect GmbH
 
-Version: v2.5.8
+Version: v2.5.10
 
-**Updated: March 19th 2026**
+**Updated: April 13th 2026**
 
 ---
 
@@ -58,7 +58,7 @@ pip install impectPy
 You can also install it from [GitHub](https://github.com/) with:
 
 ```cmd
-pip install git+https://github.com/ImpectAPI/impectPy.git@v2.5.8
+pip install git+https://github.com/ImpectAPI/impectPy.git@v2.5.10
 ```
 
 ## Usage
@@ -302,6 +302,15 @@ calls made on the client side already. The rate limit is read from the first lim
 policy sent back by the API, so if this limit increases over time, this package will
 act accordingly.
 
+### Generic API Call
+You can also use this package to make individual API calls querying a specific endpoint 
+such as the "squads" endpoint.
+
+```python
+# query any IMPECT customer API endpoint
+data = ip.getData(url=f"https://api.impect.com/v5/customerapi/iterations/{iteration}/squads", token=token)
+```
+
 ### SportsCodeXML
 
 It is also possible to convert a dataframe containing event data into an XML file,
@@ -449,6 +458,9 @@ squadIterationScores = api.getSquadIterationScores(iteration=iteration)
 
 # get player profile scores
 playerProfileScores = api.getPlayerProfileScores(iteration=iteration, positions=positions)
+
+# query single API endpoint (e.g. squads for iteration 518)
+data = api.getData(url=f"https://api.impect.com/v5/customerapi/iterations/{iteration}/squads")
 ```
 
 ## Final Notes

{impectpy-2.5.8 → impectpy-2.5.10}/impectPy.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@ setup.py
 impectPy/__init__.py
 impectPy/access_token.py
 impectPy/config.py
+impectPy/data.py
 impectPy/events.py
 impectPy/formations.py
 impectPy/generate_xml.py

{impectpy-2.5.8 → impectpy-2.5.10}/setup.py

@@ -17,7 +17,7 @@ setup(
                       "pandas>=2.2.0",
                       "numpy>=1.24.2"],
     # *strongly* suggested for sharing
-    version="2.5.8",
+    version="2.5.10",
     # The license can be anything you like
     license="MIT",
     description="A Python package to facilitate interaction with the Impect customer API",

{impectpy-2.5.8 → impectpy-2.5.10}/tests/test_package.py

@@ -10,7 +10,7 @@ from tqdm import tqdm
 from dotenv import load_dotenv
 import pandas as pd
 
-execute_functions = False
+execute_functions = True
 
 # branch comparison configuration
 BRANCH_A_NAME = "main"
@@ -110,7 +110,7 @@ if execute_functions:
         api = impectPy.Impect(config=config)
         api.login(username, password)
 
-        with tqdm(total=20, desc=f"{branch}: Executing functions...", unit="chunk") as pbar:
+        with tqdm(total=21, desc=f"{branch}: Executing functions...", unit="chunk") as pbar:
 
             # get iterations
             iterations = api.getIterations()
@@ -204,6 +204,11 @@ if execute_functions:
             playerProfileScores.to_csv(f"files/{branch}/playerProfileScores.csv")
             pbar.update()
 
+            # # get data using generic getData() method
+            # pbar.set_description("Get data using generic getData() method...")
+            # data = api.getData(f"https://api.impect.com/v5/customerapi/iterations/{iteration}/players")
+            # pbar.update()
+
 print("\nRunning auto-diff between source and test outputs...\n")
 
 base_path = Path(__file__).parent / "files"