---
title: "GET /team/{team_key}/social_media"
method: GET
path: "/team/{team_key}/social_media"
tags: ["team"]
---

# GET /team/{team_key}/social_media

`GET /team/{team_key}/social_media`

Gets a list of Media (social media) for the given team.

## Path parameters

- `team_key` string, required

## Headers

- `If-None-Match` string

## Response `200`

Successful response

- Media[]
  - union — The `Media` object contains a reference for most any media associated with a team or event on TBA.
    - MediaAvatar
      - `type` 'avatar', required — String type of the media element.
      - `foreign_key` string, required — The key used to identify this media on the media site.
      - `preferred` boolean — True if the media is of high quality.
      - `team_keys` string[], required — List of teams that this media belongs to. Most likely length 1.
      - `direct_url` string — Direct URL to the media.
      - `view_url` string — The URL that leads to the full web page for the media, if one exists.
      - `details` object
        - `base64Image` string, required
    - MediaCdPhotoThread
      - `type` 'cdphotothread', required — String type of the media element.
      - `foreign_key` string, required — The key used to identify this media on the media site.
      - `preferred` boolean — True if the media is of high quality.
      - `team_keys` string[], required — List of teams that this media belongs to. Most likely length 1.
      - `direct_url` string — Direct URL to the media.
      - `view_url` string — The URL that leads to the full web page for the media, if one exists.
      - `details` object
        - `image_partial` string, required
    - MediaCdThread
      - `type` 'cd-thread', required — String type of the media element.
      - `foreign_key` string, required — The key used to identify this media on the media site.
      - `preferred` boolean — True if the media is of high quality.
      - `team_keys` string[], required — List of teams that this media belongs to. Most likely length 1.
      - `direct_url` string — Direct URL to the media.
      - `view_url` string — The URL that leads to the full web page for the media, if one exists.
      - `details` object
        - `thread_title` string, required
        - `image_url` string, nullable, required
    - MediaGrabCad
      - `type` 'grabcad', required — String type of the media element.
      - `foreign_key` string, required — The key used to identify this media on the media site.
      - `preferred` boolean — True if the media is of high quality.
      - `team_keys` string[], required — List of teams that this media belongs to. Most likely length 1.
      - `direct_url` string — Direct URL to the media.
      - `view_url` string — The URL that leads to the full web page for the media, if one exists.
      - `details` object
        - `model_created` string, date-time, required
        - `model_description` string, nullable, required
        - `model_image` string, uri, required
        - `model_name` string, required
    - MediaNoDetails
      - `type` 'youtube' | 'imgur' | 'facebook-profile' | 'youtube-channel' | 'twitter-profile' | 'github-profile' | 'instagram-profile' | 'periscope-profile' | 'gitlab-profile' | 'instagram-image' | 'external-link', required — String type of the media element.
      - `foreign_key` string, required — The key used to identify this media on the media site.
      - `preferred` boolean — True if the media is of high quality.
      - `team_keys` string[], required — List of teams that this media belongs to. Most likely length 1.
      - `direct_url` string — Direct URL to the media.
      - `view_url` string — The URL that leads to the full web page for the media, if one exists.
      - `details` object
    - MediaOnshape
      - `type` 'onshape', required — String type of the media element.
      - `foreign_key` string, required — The key used to identify this media on the media site.
      - `preferred` boolean — True if the media is of high quality.
      - `team_keys` string[], required — List of teams that this media belongs to. Most likely length 1.
      - `direct_url` string — Direct URL to the media.
      - `view_url` string — The URL that leads to the full web page for the media, if one exists.
      - `details` object
        - `model_created` string, date-time, required
        - `model_description` string, nullable, required
        - `model_image` string, uri, required
        - `model_name` string, required

## Other responses

- `304` — Not Modified - Use Local Cached Value
- `401` — Authorization information is missing or invalid.
- `404` — Not Found

---

[API](https://skmtc.net/thebluealliance/apis/the-blue-alliance-api-v3.md) · [All operations](https://skmtc.net/thebluealliance/apis/the-blue-alliance-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thebluealliance/the-blue-alliance-api-v3/revisions/b9b0f447dbcb/schema)