Event Participants

TvSportsData/EventParticipants

Returns all participants (teams, persons, venues) from events and their stats.

Response schema: http://gns-schemas.sports.gracenote.com/gns.xsd

Request Parameters

Parameter Mandatory Description
updateId Yes

Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records.

limit Yes

Maximum number of objects to retrieve for processing predictiable batch sizes. Each iteration would retain limit number for same batch size.

Response Body

Response

Description

id

Unique Gracenote id for the event participant.

update_id The update id for the event participant.
update_action The update action for the event participant.
update_date The update date and time for the event participant.
participant_type
The participant type (e.g. ORGANIZATION, PERSON, VENUE) of the event participant.
participant_group The group for which the participant of the event belongs (e.g. HOME,AWAY, COMPETITOR, OFFICIAL).
sports_event_id
The id of the sports event for which the event participant participated.
participant_id The participant id for the event participant. This their organization id, person id or venue id.
parent_participant_id The parent participant id for the event participant. This organization id for the team a player belong to during the specific event.
participant_stats The stats (e.g. goals_period_1) for the participant during the specific event.
key  The name of the stat for the participant during the specific event.
value The value of the stat for the participant during the specific event.
participant_function
Participant function, if available, provides lineup and position information for players in an event.
id The Gracenote id for the participant function.
type The type for the participant function (e.g. DEFAULT)
value The value of the participant function (e.g. Starter).

 

Sample Response(s)

 

EVENT PARTICIPANT (ORGANIZATION):

<sports_event_participant>
        <id>GN6Y6DM0Q9DQAZ5</id>
        <meta>
            <update_id>968396</update_id>
            <update_action>UPDATE</update_action>
            <update_date>2017-06-06T15:37:24Z</update_date>
        </meta>
        <participant_type>ORGANIZATION</participant_type>
        <participant_group>AWAY</participant_group>
        <sports_event_id>GNBTG3X27214SVV</sports_event_id>
        <participant_id>GNBZAAA1DMY5T4D</participant_id>
        <participant_stats>
            <entry>
                <key>player_time_on_ice_short_handed_secs</key>
                <value>480.0</value>
            </entry>
            <entry>
                <key>goalie_time_on_ice_short_handed_secs</key>
                <value>120.0</value>
            </entry>
            <entry>
                <key>penalties</key>
                <value>1.0</value>
            </entry>
            <entry>
                <key>player_points</key>
                <value>3.0</value>
            </entry>
            <entry>
                <key>goals_period_1</key>
                <value>1.0</value>
            </entry>
            <entry>
                <key>goalie_shots_against</key>
                <value>24.0</value>
            </entry>
            <entry>
                <key>power_plays</key>
                <value>1.0</value>
            </entry>
            <entry>
                <key>player_plus_minus</key>
                <value>1.0</value>
            </entry>
            <entry>
                <key>player_time_on_ice_power_play_secs</key>
                <value>30.0</value>
            </entry>
            <entry>
                <key>power_plays_against</key>
                <value>1.0</value>
            </entry>
            <entry>
                <key>faceoff_total_losses</key>
                <value>27.0</value>
            </entry>
            <entry>
                <key>penalty_minutes</key>
                <value>2.0</value>
            </entry>
            <entry>
                <key>faceoff_win_percentage</key>
                <value>0.46</value>
            </entry>
            <entry>
                <key>save_percentage</key>
                <value>0.9166666666666666</value>
            </entry>
            <entry>
                <key>goals</key>
                <value>1.0</value>
            </entry>
            <entry>
                <key>penalty_kill_percentage</key>
                <value>1.0</value>
            </entry>
            <entry>
                <key>goalie_time_on_ice_secs</key>
                <value>3468.0</value>
            </entry>
            <entry>
                <key>goalie_saves</key>
                <value>22.0</value>
            </entry>
            <entry>
                <key>total_play_time</key>
                <value>3600.0</value>
            </entry>
            <entry>
                <key>goalie_goals_against</key>
                <value>2.0</value>
            </entry>
            <entry>
                <key>games_played</key>
                <value>1.0</value>
            </entry>
            <entry>
                <key>faceoff_total_wins</key>
                <value>23.0</value>
            </entry>
            <entry>
                <key>player_hits</key>
                <value>14.0</value>
            </entry>
            <entry>
                <key>goalie_goals_against_average</key>
                <value>2.0761247</value>
            </entry>
            <entry>
                <key>player_blocked_shots</key>
                <value>8.0</value>
            </entry>
            <entry>
                <key>player_assists</key>
                <value>2.0</value>
            </entry>
            <entry>
                <key>games_lost</key>
                <value>1.0</value>
            </entry>
            <entry>
                <key>shots</key>
                <value>33.0</value>
            </entry>
            <entry>
                <key>power_play_percentage</key>
                <value>0.0</value>
            </entry>
            <entry>
                <key>shooting_percentage</key>
                <value>0.030303030303030304</value>
            </entry>
            <entry>
                <key>shots_period_1</key>
                <value>9.0</value>
            </entry>
            <entry>
                <key>shots_period_2</key>
                <value>8.0</value>
            </entry>
            <entry>
                <key>shots_period_3</key>
                <value>16.0</value>
            </entry>
        </participant_stats>
    </sports_event_participant>

EVENT PARTICIPANT (PERSON):

<sports_event_participant>
        <id>GNA2BAZCAPVXA64</id>
        <meta>
            <update_id>970274</update_id>
            <update_action>UPDATE</update_action>
            <update_date>2017-06-06T15:44:47Z</update_date>
        </meta>
        <participant_type>PERSON</participant_type>
        <participant_group>COMPETITOR</participant_group>
        <sports_event_id>GNBTG3X27214SVV</sports_event_id>
        <participant_id>GNFN9SKK5R32HGG</participant_id>
        <parent_participant_id>GN85SQX3WN3Q52X</parent_participant_id>
        <participant_stats>
            <entry>
                <key>shifts</key>
                <value>21</value>
            </entry>
            <entry>
                <key>games_played</key>
                <value>1</value>
            </entry>
            <entry>
                <key>blocked_shots</key>
                <value>2</value>
            </entry>
            <entry>
                <key>time_on_ice_secs</key>
                <value>994</value>
            </entry>
            <entry>
                <key>time_on_ice_even_strength_secs</key>
                <value>994</value>
            </entry>
            <entry>
                <key>plus_minus</key>
                <value>-1</value>
            </entry>
        </participant_stats>
    </sports_event_participant>