Get Social Data
Retrieve time-series social media metrics for a company across 8 major platforms.
Authentication
All endpoints require X-API-Key header authentication. See Getting Started for details.
Scope required: social:{platform} or social:* wildcard.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
platform | string | One of: x, instagram, threads, tiktok, pinterest, youtube, facebook, reddit |
ticker | string | Stock ticker symbol (e.g., AAPL, TSLA) |
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
from_date | date | 365 days ago | Start date (format: YYYY-MM-DD) |
to_date | date | today | End date (format: YYYY-MM-DD) |
Response
Returns a SocialSeriesResponse object. Only relevant metrics are included -- fields with null values are omitted.
SocialDataPoint
A single data point in the time series.
| Field | Type | Required | Description |
|---|---|---|---|
date | date | Yes | Date of the data point (YYYY-MM-DD) |
followers | integer | No | Follower count (all platforms use this key) |
mentions | integer | No | Mention count (X, Reddit) |
sentiment | integer | No | Sentiment score (0-100) |
SocialSeriesResponse
Complete response for a social metrics request.
| Field | Type | Required | Description |
|---|---|---|---|
ticker | string | Yes | Entity ticker symbol |
platform | string | Yes | Platform name |
handle | string | null | No | Platform-specific handle/username |
from_date | date | Yes | Start of date range |
to_date | date | Yes | End of date range |
data | SocialDataPoint[] | Yes | Array of daily data points |
For detailed definitions of each metric and platform-specific behavior, see Social Followers and Mentions & Sentiment in the Data Dictionary.
Error Responses
| Status | Code | Description |
|---|---|---|
| 401 | MISSING_API_KEY | No API key provided in the X-API-Key header |
| 403 | INVALID_API_KEY | API key is invalid or has been revoked |
| 403 | INSUFFICIENT_SCOPE | API key does not have the required platform scope |
| 404 | ENTITY_NOT_FOUND | The requested ticker does not exist |
| 429 | RATE_LIMIT_EXCEEDED | Daily request limit exceeded |
For the full error envelope format, see Error Handling.
GET/api/social/{platform}/{ticker}
cURL
curl -X GET "https://v2.api.altindex.com/api/social/x/AAPL?from_date=2025-01-01&to_date=2026-02-04" \
-H "X-API-Key: your_api_key_here"200Retrieved
{
"ticker": "AAPL",
"platform": "x",
"handle": "apple",
"from_date": "2025-01-01",
"to_date": "2026-02-04",
"data": [
{
"date": "2026-02-04",
"followers": 9939698,
"mentions": 655,
"sentiment": 72
},
{
"date": "2026-02-03",
"followers": 9939683,
"mentions": 245,
"sentiment": 64
},
{
"date": "2026-02-02",
"followers": 9939922,
"mentions": 785,
"sentiment": 73
}
]
}