Find Sports Event Participants by Sports Event ID

gns-api/EventParticipants

API to return the participants (teams, persons, venus) and their stats for a specific Sports Event ID.

Response Schema: https://gns-schemas.sports.gracenote.com/gns.xsd / https://gns-schemas.sports.gracenote.com/gns.json

Request Parameters

Parameter Mandatory Description Example(s) 
sportsEventId Yes

If you already have a sport event’s GN id you can use that to find the event participants.

accept Yes

Choose between XML and JSON for the response.

skip No Indicate the number of results to skip in the response.
limit No Indicate the maximum number of results in the response.
include No Allows you to "include" full information for an applicable entity in the response.  For example, including "sportsEventId" will add all of the data for the sports event (id, description, status, state etc.) for the associated sportEventId in the response. 
sportsEventId, participantId
fields No Allows you to return the id(s) and a specific field(s) in the response.

Response Body

Response

Description

id

Unique Gracenote id for the event participant.

meta Container for the update information.
update_date Update date and time for the event participant
participant_type The type of event participant (e.g. ORGANIZATION, PERSON, VENUE)
participant_group The group that the participant of the event belongs to (e.g. HOME, AWAY, COMPETITOR, OFFICIAL)
sports_event_id The id of the sports event that the participant participated.
participant_id The participant id for the event participant. This is their organization id, person id, or venue id.
parent_participant_id The parent participant id for the event participant. This could be the organization id for the team a player belongs 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

Sample Request

sportsEventId: GN09ZYXRY3PK8X4

Sample Response

 

<?xml version='1.0'?>
<gns>
    <sports_event_participants>
        <sports_event_participant>
            <id>GNBSA8DH8MMAGVH</id>
            <meta>
                <update_date>2018-01-29T02:29:25.672Z</update_date>
            </meta>
            <participant_type>PERSON</participant_type>
            <participant_group>COMPETITOR</participant_group>
            <sports_event_id>GN09ZYXRY3PK8X4</sports_event_id>
            <participant_id>GN0R3ZE6A07HHCH</participant_id>
            <parent_participant_id>GN4PEAH9GCYGMK1</parent_participant_id>
            <participant_functions>
                <participant_function>
                    <id>GN5F7CWW3EMNQQ9</id>
                    <names>
                        <name>
                            <type>DEFAULT</type>
                            <value>Starter</value>
                        </name>
                    </names>
                </participant_function>
                <participant_function>
                    <id>GNF9HM5NJV1WCTS</id>
                    <names>
                        <name>
                            <type>DEFAULT</type>
                            <value>Guard</value>
                        </name>
                        <name>
                            <type>SHORT</type>
                            <value>G</value>
                        </name>
                    </names>
                </participant_function>
            </participant_functions>
            <participant_stats>
                <entry>
                    <key>total_rebounds</key>
                    <value>4.0</value>
                </entry>
                <entry>
                    <key>field_goals_made</key>
                    <value>2</value>
                </entry>
                <entry>
                    <key>free_throw_percentage</key>
                    <value>0.0</value>
                </entry>
                <entry>
                    <key>free_throws_attempted</key>
                    <value>1</value>
                </entry>
                <entry>
                    <key>field_goal_percentage</key>
                    <value>0.5</value>
                </entry>
                <entry>
                    <key>games_played</key>
                    <value>1</value>
                </entry>
                <entry>
                    <key>three_point_field_goals_attempted</key>
                    <value>1</value>
                </entry>
                <entry>
                    <key>points</key>
                    <value>4</value>
                </entry>
                <entry>
                    <key>plus_minus</key>
                    <value>-7</value>
                </entry>
                <entry>
                    <key>rebounds_defensive</key>
                    <value>4</value>
                </entry>
                <entry>
                    <key>three_point_field_goals_percentage</key>
                    <value>0.0</value>
                </entry>
                <entry>
                    <key>assists</key>
                    <value>2</value>
                </entry>
                <entry>
                    <key>points_highest</key>
                    <value>4</value>
                </entry>
                <entry>
                    <key>field_goals_attempted</key>
                    <value>4</value>
                </entry>
                <entry>
                    <key>turnovers</key>
                    <value>1</value>
                </entry>
                <entry>
                    <key>games_started</key>
                    <value>1</value>
                </entry>
                <entry>
                    <key>seconds_played</key>
                    <value>1304</value>
                </entry>
                <entry>
                    <key>true_shooting_percentage</key>
                    <value>0.4504504504504504</value>
                </entry>
            </participant_stats>
        </sports_event_participant>
    </sports_event_participants>
</gns>

Docs Navigation