Find Images by Sports Event Participant ID

gns-api/images

API to return the image(s) for a specific Sports Event Participant ID.

The images that are associated with sports event participants are player headshots, team logos and venues (for applicable leagues).

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

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

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 reponse. 
sportsEventId
fields No Allows you to return the id(s) and a specific field(s) in the response. In the case of images, this is not applicable.

Response Body

Response

Description

id

Unique Gracenote id for the image.

update_id The update id for the image.
update_action The update action for the image.
update_date The update date and time for the image.
exif_data
key Image data description (e.g. image_height, image_width).
value The value of the image data.
url The url for the image.
entity_id The Gracenote id for the entity associated with the image.
entity_type The type of entity that the image is associated with (e.g. sports_event, sports_event_participant).
type The type of image (e.g. banner, player_headshot, team_logo, venue_interior).
style The style of the image, if applicable. If not, "default".

 

Sample Response

IMAGE (PLAYER HEADSHOT):

            <image>
                <id>GN587B9P42ET21Z</id>
                <meta>
                    <update_date>2017-06-12T21:18:37Z</update_date>
                </meta>
                <exifData>
                    <entry>
                        <key>ImageHeight</key>
                        <value>250</value>
                    </entry>
                    <entry>
                        <key>ImageWidth</key>
                        <value>250</value>
                    </entry>
                </exifData>
                <url>
                    https://www.gannett-cdn.com/usatsimg/image/thumb/250-250/10479989.png
                </url>
                <entity_id>GN5DK53XVQ4ZPKZ</entity_id>
                <entity_type>sports_event_participant</entity_type>
                <type>player_headshot</type>
                <style>default</style>
            </image>

 
IMAGE (TEAM LOGO):

            <image>
                <id>GN2KNQMBQA9D8RY</id>
                <meta>
                    <update_date>2017-06-12T21:18:37Z</update_date>
                </meta>
                <exifData>
                    <entry>
                        <key>ImageHeight</key>
                        <value>300</value>
                    </entry>
                    <entry>
                        <key>ImageWidth</key>
                        <value>300</value>
                    </entry>
                </exifData>
                <url>
                    http://tms-image-store.s3.amazonaws.com/944d40583c4bfcb626ed407eba35948b.png
                </url>
                <entity_id>GNABW87RF0M40HD</entity_id>
                <entity_type>sports_event_participant</entity_type>
                <type>team_logo</type>
                <style>default</style>
            </image>  


IMAGE (VENUE):

            <image>
                <id>GNBVN1RAYTSE17M</id>
                <meta>
                    <update_date>2017-06-12T21:18:37Z</update_date>
                </meta>
                <url>
                    http://thumb.usatodaysportsimages.com/image/thumb/1150-1150nw/7239412.jpg
                </url>
                <entity_id>GN5HGT79XVMNSMA</entity_id>
                <entity_type>sports_event_participant</entity_type>
                <type>venue_interior</type>
                <style>default</style>
            </image>