GET /ai_score
AI score timeline and rankings endpoint.
Description
Returns AI score data for companies.
Behavior depends on parameters:
symbol=<ticker>: Returns AI score timeline for a specific ticker (up to 600 days of history).- No symbol: Returns all active companies with their current AI scores.
order=desc: Returns top 100 companies ranked by AI score (requires no symbol).
AI scores include:
- Overall AI score: Composite score from all components
- Audience score: Social media and audience engagement metrics
- Employment score: Hiring activity and employee sentiment
- Customer score: App performance and customer satisfaction
- Fundamental score: Financial health indicators
Endpoint
GET https://api.altindex.com/ai_score/Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
apikey | string | Yes | Your API key. apiKey also works. |
symbol | string | No | Stock ticker symbol. If omitted, returns all companies. |
order | string | No | Sort order. Use desc to get top 100 companies by AI score. |
Example Request (Single Ticker)
curl "https://api.altindex.com/ai_score/?apiKey=YOUR_API_KEY&symbol=TSLA"Example Response (Single Ticker)
{
"status": 200,
"id": "1",
"name": "Tesla",
"logo": "https://altindex.com/assets/images/tickers/TSLA.jpg",
"domain": "tesla.com",
"ticker": "TSLA",
"description": "Tesla, Inc. designs, develops...",
"industry": "Autos",
"timeline": [
{
"date": "2026-01-15",
"ai_score": 78,
"ai_audience": 82,
"ai_employment": 71,
"ai_customer": 85,
"ai_fundamental": 74
},
{
"date": "2026-01-14",
"ai_score": 77,
"ai_audience": 81,
"ai_employment": 72,
"ai_customer": 84,
"ai_fundamental": 73
}
]
}Example Request (Top 100)
curl "https://api.altindex.com/ai_score/?apiKey=YOUR_API_KEY&order=desc"Example Response (Top 100)
{
"status": 200,
"results": [
{
"ticker": "NVDA",
"name": "NVIDIA",
"logo": "https://altindex.com/assets/images/tickers/NVDA.jpg",
"ai_score": 92
},
{
"ticker": "TSLA",
"name": "Tesla",
"logo": "https://altindex.com/assets/images/tickers/TSLA.jpg",
"ai_score": 78
}
]
}Timeline Response Fields
| Field | Type | Description |
|---|---|---|
status | integer | HTTP status code |
id | string | Entity ID |
name | string | Company name |
logo | string | URL to company logo |
domain | string | Company domain |
ticker | string | Ticker symbol |
description | string | Company description |
industry | string | Industry classification |
timeline | array | Array of daily AI score data points |
Timeline Data Fields
| Field | Type | Description |
|---|---|---|
date | string | Date (YYYY-MM-DD) |
ai_score | number | Overall AI score |
ai_audience | number | Audience component score |
ai_employment | number | Employment component score |
ai_customer | number | Customer component score |
ai_fundamental | number | Fundamental component score |
Results Response Fields (Top 100)
| Field | Type | Description |
|---|---|---|
status | integer | HTTP status code |
results | array | Array of companies with AI scores |
results[].ticker | string | Ticker symbol |
results[].name | string | Company name |
results[].logo | string | URL to company logo |
results[].ai_score | number | Current AI score |