Docs/socials
GET
/socials
Closed Beta — Add-On Required
Social profiles for players and teams: handle, follower count, profile image, verified flag, and 7-day / 30-day follower growth — grouped by platform (X.com, Instagram, YouTube, TikTok).
Closed beta. Access is gated per company. Pricing when GA: $349 first month, then $79/month. Request invite →
Redistribution or resale requires a partnership agreement (starting at $1,500/month). No refunds after the first /socials call is made.
Request
cURL example
# League snapshot curl -H "Authorization: YOUR_API_KEY" \ "https://api.sportfeeds.com/v1/socials?league=NBA&platform=x" # Specific players curl -H "Authorization: YOUR_API_KEY" \ "https://api.sportfeeds.com/v1/socials?players=1966,3917376&id_type=espn" # Specific teams curl -H "Authorization: YOUR_API_KEY" \ "https://api.sportfeeds.com/v1/socials?teams=LAL,BOS&team_id_type=code"
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| league | enum | No | NFL, NBA, MLB, NHL, PGA, NCAAMB. Required unless players= or teams= is supplied. |
| players | string (CSV) | No | Player IDs. Switches mode to players. |
| teams | string (CSV) | No | Team IDs. Switches mode to teams. |
| platform | enum | No | Filter to x, instagram, youtube, or tiktok. |
| position | string | No | Filter players by position (player mode only). |
| id_type | enum | No | Player ID encoding (sportfeeds, espn, sportradar, …). Default: sportfeeds. |
| team_id_type | enum | No | Team ID encoding (sportfeeds, code, espn, …). Default: sportfeeds. |
| limit | int | No | 1–200. Default 50. |
| page | int | No | 1-indexed page. Default 1. |
Example Response
{
"ok": true,
"pagination": { "page": 1, "limit": 50, "total": 540, "has_next": true },
"league": "NBA",
"platform": "x",
"items": [
{
"player": {
"id": 8001,
"name": "LeBron James",
"position": "F",
"team_id": 13,
"league": "NBA"
},
"socials": [
{
"platform": "x",
"handle": "KingJames",
"followers": 53210000,
"profile_image_url": "https://...",
"verified": true,
"growth_7d": { "abs": 12000, "pct": 0.023 },
"growth_30d": { "abs": 50000, "pct": 0.094 },
"url": "https://x.com/KingJames"
}
]
}
]
}Without an active add-on, this endpoint returns 403 SOCIAL_ACCESS_REQUIRED.