Persons

TvSportsData/Persons

Returns all people (players, officials).

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 venue.

update_id The update id for the venue.
update_action The update action for the venue.
update_date The update date and time for the venue.

xids

Container for external ids to connect to data in other Gracenote APIs and/or legacy data.

supplier Name of the supplier (e.g. sportsdirect, infostrada, tms) of the xid.
type The description of the supplier's id keyspace.
id The supplier's id for the associated entity.
name The name of the person.
type The type of name for the person (e.g. FIRST, LAST).
value The value for the type of name for the person (e.g. Sidney Crosby)
birthdate The birthdate (e,g, 1987-03-31) for the person.
height_inches The height of the person in inches.
height_millimetres The height of the person in millimetres.
weight_pounds The weight of the person in pounds.
weight_grams The weight of the person in grams.
gender The gender of the person.
birth_place The birth place of the person.
city The city for the venue.
state The state for the venue, if applicable.
country The country for the venue.

 

Sample Response(s)

 

PERSON (ATHLETE):

<gns:gns xmlns:gns="http://xml.gracenote.com/gns/v1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="gns.xsd">
        <persons>
            <person>
                <id>GNB90Z51QAHE1SD</id>
                <meta>
                    <update_id>92453</update_id>
                    <update_action>UPDATE</update_action>
                    <update_date>2017-05-25T14:12:11Z</update_date>
                </meta>
                <xids>
                    <xid>
                        <supplier>sportsdirect</supplier>
                        <type>xml</type>
                        <id>/sport/baseball/player:105305</id>
                    </xid>
                    <xid>
                        <supplier>infostrada</supplier>
                        <type>general_person</type>
                        <id>1586928</id>
                    </xid>
                </xids>
                <names>
                    <name>
                        <type>FIRST</type>
                        <value>Peter</value>
                    </name>
                    <name>
                        <type>LAST</type>
                        <value>Bourjos</value>
                    </name>
                </names>
                <birthdate>1987-03-31</birthdate>
                <height_inches>73</height_inches>
                <weight_pounds>175</weight_pounds>
                <height_millimetres>1854</height_millimetres>
                <weight_grams>79378</weight_grams>
                <gender>MALE</gender>
                <birth_place>
                    <city>Park Ridge</city>
                    <state>Illinois</state>
                    <country>USA</country>
                </birth_place>
            </person>
        </persons>
    </gns:gns>