API V1 (Legacy)
Reference
GET /ai_score

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

ParameterTypeRequiredDescription
apikeystringYesYour API key. apiKey also works.
symbolstringNoStock ticker symbol. If omitted, returns all companies.
orderstringNoSort 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

FieldTypeDescription
statusintegerHTTP status code
idstringEntity ID
namestringCompany name
logostringURL to company logo
domainstringCompany domain
tickerstringTicker symbol
descriptionstringCompany description
industrystringIndustry classification
timelinearrayArray of daily AI score data points

Timeline Data Fields

FieldTypeDescription
datestringDate (YYYY-MM-DD)
ai_scorenumberOverall AI score
ai_audiencenumberAudience component score
ai_employmentnumberEmployment component score
ai_customernumberCustomer component score
ai_fundamentalnumberFundamental component score

Results Response Fields (Top 100)

FieldTypeDescription
statusintegerHTTP status code
resultsarrayArray of companies with AI scores
results[].tickerstringTicker symbol
results[].namestringCompany name
results[].logostringURL to company logo
results[].ai_scorenumberCurrent AI score