Find Sports Event Participants by Query

gns-api/EventParticipants

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

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) 
query Yes

Make a request based on specific query. See examples below.

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.

Queries

Query Description Example
participanttype Make a request based on the type(s) of event participant. {"participantType": "VENUE"}
participantgroup Make a request based on the group that the participant belongs to. {"participantGroup": "COMPETITOR"}
sportseventid Make a request based on the sports event that a participant particiapted. {"sportsEventId":"GN09ZYXRY3PK8X4"}
participantid Make a request based on the participant id of an event participant.  {"participantId":"GND7S070XHWGB45"}
parentparticipantid Make a request for event participants based on the parent event participant id. {"parentparticipantId":"GN1QC2NZT991P7H"}
participantstats Make a request for event participants based on a specific stat. Combine "sportseventid" with your query to narrow down to specific types of events {"gamesWon":"5", "sportsEventId":"GN94400YPFSM88X"}
{} Returns all sports actions. {}


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

1. Return all event participants for L.A. Lakers when at home.

{"participantId":"GND7S070XHWGB45", "participantGroup":"HOME"}

2. Return all players in the EUFA Champions League Final.

{"sportsEventId":"GNB4KR3TTGMESD9","participantType":"person"}

include: participantId

Sample Response

1. L.A. Lakers participants at home.
<gns>
    <sports_event_participants>
        <sports_event_participant>
            <id>GNC7F4J9HW29HVK</id>
            <meta>
                <update_date>2017-07-12T18:56:52.296Z</update_date>
            </meta>
            <participant_type>ORGANIZATION</participant_type>
            <participant_group>HOME</participant_group>
            <sports_event_id>GNCMRFD6BCX9NY9</sports_event_id>
            <participant_id>GND7S070XHWGB45</participant_id>
            <participant_stats>
                <entry>
                    <key>free_throws_made</key>
                    <value>23.0</value>
                </entry>
                <entry>
                    <key>total_rebounds</key>
                    <value>44.0</value>
                </entry>
                <entry>
                    <key>field_goal_percentage</key>
                    <value>0.4166666666666667</value>
                </entry>
                <entry>
                    <key>fouls_personal</key>
                    <value>24.0</value>
                </entry>
                <entry>
                    <key>steals</key>
                    <value>11.0</value>
                </entry>
                <entry>
                    <key>points</key>
                    <value>112.0</value>
                </entry>
                <entry>
                    <key>assists</key>
                    <value>21.0</value>
                </entry>
                <entry>
                    <key>points_highest</key>
                    <value>112.0</value>
                </entry>
                <entry>
                    <key>field_goals_attempted</key>
                    <value>96.0</value>
                </entry>
                <entry>
                    <key>points_in_paint</key>
                    <value>46.0</value>
                </entry>
                <entry>
                    <key>true_shooting_percentage</key>
                    <value>0.5169867060561301</value>
                </entry>
                <entry>
                    <key>points_biggest_lead</key>
                    <value>8.0</value>
                </entry>
                <entry>
                    <key>games_won</key>
                    <value>1.0</value>
                </entry>
                <entry>
                    <key>field_goals_made</key>
                    <value>40.0</value>
                </entry>
                <entry>
                    <key>three_point_field_goals_made</key>
                    <value>9.0</value>
                </entry>
                <entry>
                    <key>free_throw_percentage</key>
                    <value>0.8214285714285714</value>
                </entry>
                <entry>
                    <key>free_throws_attempted</key>
                    <value>28.0</value>
                </entry>
                <entry>
                    <key>blocks</key>
                    <value>4.0</value>
                </entry>
                <entry>
                    <key>points_quarter_1</key>
                    <value>26.0</value>
                </entry>
                <entry>
                    <key>points_quarter_2</key>
                    <value>25.0</value>
                </entry>
                <entry>
                    <key>games_played</key>
                    <value>1.0</value>
                </entry>
                <entry>
                    <key>three_point_field_goals_attempted</key>
                    <value>21.0</value>
                </entry>
                <entry>
                    <key>three_point_percentage</key>
                    <value>0.42857142857142855</value>
                </entry>
                <entry>
                    <key>rebounds_team</key>
                    <value>8.0</value>
                </entry>
                <entry>
                    <key>points_quarter_3</key>
                    <value>26.0</value>
                </entry>
                <entry>
                    <key>points_quarter_4</key>
                    <value>35.0</value>
                </entry>
                <entry>
                    <key>fouls_technical</key>
                    <value>1.0</value>
                </entry>
                <entry>
                    <key>rebounds_defensive</key>
                    <value>30.0</value>
                </entry>
                <entry>
                    <key>rebounds_offensive</key>
                    <value>14.0</value>
                </entry>
                <entry>
                    <key>turnovers</key>
                    <value>12.0</value>
                </entry>
                <entry>
                    <key>points_fast_break</key>
                    <value>12.0</value>
                </entry>
            </participant_stats>
        </sports_event_participant>
    </sports_event_participants>
</gns>



2. Players in the Champions League Final
 <persons>
        <person>
            <id>GN0WDHA3H1Q3RJ7</id>
            <meta>
                <update_date>2018-09-05T06:22:47.091Z</update_date>
            </meta>
            <xids>
                <xid>
                    <supplier>sportsdirect</supplier>
                    <type>xml</type>
                    <id>/sport/soccer/player:33452</id>
                </xid>
                <xid>
                    <supplier>infostrada</supplier>
                    <type>general_person</type>
                    <id>664067</id>
                </xid>
            </xids>
            <names>
                <name>
                    <type>FIRST</type>
                    <value>Georginio</value>
                </name>
                <name>
                    <type>LAST</type>
                    <value>Wijnaldum</value>
                </name>
                <name>
                    <type>FULL</type>
                    <value>Georginio Wijnaldum</value>
                </name>
                <name>
                    <type>DISPLAY</type>
                    <value>Georginio Wijnaldum</value>
                </name>
            </names>
            <nationality>Netherlands</nationality>
            <birthdate>1990-11-11</birthdate>
            <height_inches>68</height_inches>
            <weight_pounds>163</weight_pounds>
            <height_millimetres>1750</height_millimetres>
            <weight_grams>74000</weight_grams>
            <gender>MALE</gender>
            <birth_place>
                <city>Rotterdam</city>
                <country>Netherlands</country>
            </birth_place>
        </person>
        <person>
            <id>GN16TKMFF8ANQDZ</id>
            <meta>
                <update_date>2018-09-05T06:22:09.918Z</update_date>
            </meta>
            <xids>
                <xid>
                    <supplier>sportsdirect</supplier>
                    <type>xml</type>
                    <id>/sport/soccer/player:32058</id>
                </xid>
                <xid>
                    <supplier>infostrada</supplier>
                    <type>general_person</type>
                    <id>602112</id>
                </xid>
            </xids>
            <names>
                <name>
                    <type>FIRST</type>
                    <value>Keylor</value>
                </name>
                <name>
                    <type>LAST</type>
                    <value>Navas</value>
                </name>
                <name>
                    <type>FULL</type>
                    <value>Keylor Antonio Navas Gamboa</value>
                </name>
                <name>
                    <type>DISPLAY</type>
                    <value>Keylor Navas</value>
                </name>
            </names>
            <nationality>Costa Rica</nationality>
            <birthdate>1986-12-15</birthdate>
            <height_inches>72</height_inches>
            <weight_pounds>176</weight_pounds>
            <height_millimetres>1850</height_millimetres>
            <weight_grams>80000</weight_grams>
            <gender>MALE</gender>
            <birth_place>
                <city>Pérez Zeledón</city>
                <country>Costa Rica</country>
            </birth_place>
        </person>

etc...

 <sports_event_participant>
            <id>GND0VT19MS9X68J</id>
            <meta>
                <update_date>2018-07-30T14:05:48.118Z</update_date>
            </meta>
            <participant_type>PERSON</participant_type>
            <participant_group>COMPETITOR</participant_group>
            <sports_event_id>GNB4KR3TTGMESD9</sports_event_id>
            <participant_id>GN5Z86GKAEVF8TZ</participant_id>
            <parent_participant_id>GN27HXW31J4Y1VH</parent_participant_id>
            <participant_functions>
                <participant_function>
                    <id>GNBN82M8R16BE06</id>
                    <names>
                        <name>
                            <type>DEFAULT</type>
                            <value>Substitute</value>
                        </name>
                        <name>
                            <type>SHORT</type>
                            <value>S</value>
                        </name>
                    </names>
                </participant_function>
                <participant_function>
                    <id>GNETBDK0XH3K0XZ</id>
                    <names>
                        <name>
                            <type>DEFAULT</type>
                            <value>Midfielder</value>
                        </name>
                        <name>
                            <type>SHORT</type>
                            <value>M</value>
                        </name>
                    </names>
                </participant_function>
            </participant_functions>
            <participant_properties>
                <participant_property>
                    <key>LINEUP_STATUS</key>
                    <value>
                        <id>GNBN82M8R16BE06</id>
                        <names>
                            <value>Substitute</value>
                            <type>DEFAULT</type>
                        </names>
                        <names>
                            <value>S</value>
                            <type>SHORT</type>
                        </names>
                    </value>
                </participant_property>
                <participant_property>
                    <key>POSITION</key>
                    <value>
                        <id>GNETBDK0XH3K0XZ</id>
                        <names>
                            <value>Midfielder</value>
                            <type>DEFAULT</type>
                        </names>
                        <names>
                            <value>M</value>
                            <type>SHORT</type>
                        </names>
                    </value>
                </participant_property>
            </participant_properties>
            <participant_scalar_properties>
                <participant_scalar_property>
                    <key>UNIFORM_NUMBER</key>
                    <value>20</value>
                </participant_scalar_property>
                <participant_scalar_property>
                    <key>POSITION_NUMBER</key>
                    <value>10</value>
                </participant_scalar_property>
            </participant_scalar_properties>
            <participant_stats>
                <entry>
                    <key>fouls</key>
                    <value>1</value>
                </entry>
                <entry>
                    <key>fouls_against</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>shots_blocked_by</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>cards_yellow</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>shots_woodwork</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>crosses</key>
                    <value>1</value>
                </entry>
                <entry>
                    <key>freekicks</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>cards_red_indirect</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>corners</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>shots_on_goal</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>assists</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>pass_accuracy</key>
                    <value>100</value>
                </entry>
                <entry>
                    <key>passes_total</key>
                    <value>1</value>
                </entry>
                <entry>
                    <key>cards_red_direct</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>shots_blocked</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>goals</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>dribbles_succes</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>passes_complete</key>
                    <value>1</value>
                </entry>
                <entry>
                    <key>interceptions</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>passes_incomplete</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>scoring_opportunities</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>shots_wide</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>tackles_won</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>off_side</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>shots</key>
                    <value>0</value>
                </entry>
            </participant_stats>
        </sports_event_participant>
        <sports_event_participant>
            <id>GNDTY9RD1R1XH4P</id>
            <meta>
                <update_date>2018-08-13T13:31:36.728Z</update_date>
            </meta>
            <participant_type>PERSON</participant_type>
            <participant_group>OFFICIAL</participant_group>
            <sports_event_id>GNB4KR3TTGMESD9</sports_event_id>
            <participant_id>GN61K1XGPP8V98F</participant_id>
            <participant_stats>
                <entry>
                    <key>fouls</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>fouls_against</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>shots_blocked_by</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>cards_yellow</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>shots_woodwork</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>freekicks</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>scoring_opportunities</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>cards_red_indirect</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>corners</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>shots_on_goal</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>assists</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>shots_wide</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>cards_red_direct</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>shots_blocked</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>off_side</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>shots</key>
                    <value>0</value>
                </entry>
                <entry>
                    <key>goals</key>
                    <value>0</value>
                </entry>
            </participant_stats>
        </sports_event_participant>