GET /industry_benchmark
Industry benchmark comparisons endpoint.
Description
Returns benchmark comparisons for a ticker against its industry peers.
For each metric, returns:
- Current value and previous value
- Delta (percentage change)
- Benchmark score (0-1, where 1 means leading the industry)
- Peer comparison data
Metrics include social followers, mentions, sentiment, job postings, web traffic, app downloads, and more.
Endpoint
GET https://api.altindex.com/industry_benchmark/Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
apikey | string | Yes | Your API key. apiKey also works. |
symbol | string | Yes | Stock ticker symbol (e.g., TSLA). |
Example Request
curl "https://api.altindex.com/industry_benchmark/?apiKey=YOUR_API_KEY&symbol=TSLA"Example Response
{
"status": 200,
"symbol": "TSLA",
"data": {
"twitter_followers": {
"date": "2026-01-15",
"value": 25400000,
"previous_value": 24800000,
"delta": 2.42,
"benchmark": 0.95,
"peers": [
{
"id": "2",
"name": "Ford Motor",
"ticker": "F",
"domain": "ford.com",
"logo": "https://altindex.com/assets/images/tickers/F.jpg",
"value": 5200000,
"previous_value": 5150000,
"delta": 0.97
}
]
},
"reddit_mentions": {
"date": "2026-01-15",
"value": 245,
"previous_value": 198,
"delta": 23.74,
"benchmark": 0.88,
"peers": [...]
}
}
}Response Fields
| Field | Type | Description |
|---|---|---|
status | integer | HTTP status code |
symbol | string | Ticker symbol |
data | object | Object containing benchmark metrics |
Metric Fields
Each metric in the data object contains:
| Field | Type | Description |
|---|---|---|
date | string | Date of the data point |
value | number | Current metric value |
previous_value | number | Previous period value |
delta | number | Percentage change from previous value |
benchmark | number | Score from 0-1 indicating position vs industry peers (1 = leading) |
peers | array | Array of peer company data |
Peer Fields
| Field | Type | Description |
|---|---|---|
id | string | Peer entity ID |
name | string | Peer company name |
ticker | string | Peer ticker symbol |
domain | string | Peer company domain |
logo | string | URL to peer logo |
value | number | Peer's current metric value |
previous_value | number | Peer's previous period value |
delta | number | Peer's percentage change |