GET /timeline

Alternative-data timeline endpoint.

Description

Returns a comprehensive historical timeline of alternative data metrics for a ticker.

Includes daily and monthly data points covering:

Social metrics: Reddit, Twitter/X, Stocktwits, TikTok, Instagram, Facebook, YouTube mentions and followers
App metrics: iOS/Android downloads, ratings, store rankings
Employment metrics: Job postings, employee counts
Financial metrics: Price, target price, AI price prediction
AI scores: Overall score and component scores
Employer ratings: Glassdoor ratings, business outlook
Web traffic: Monthly web traffic estimates

Endpoint

GET https://api.altindex.com/timeline/

Parameters

Parameter	Type	Required	Description
`apikey`	string	Yes	Your API key. `apiKey` also works.
`symbol`	string	Yes	Stock ticker symbol (e.g., `TSLA`).
`date`	string	No	Specific date to retrieve (YYYY-MM-DD). If omitted, returns historical data.
`data`	string	No	Comma-separated list of data types. Use `job_posts,webtraffic` for a simplified response.

Example Request

curl "https://api.altindex.com/timeline/?apiKey=YOUR_API_KEY&symbol=TSLA"

Example Response

{
  "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",
  "peers": ["F", "GM", "RIVN", "LCID"],
  "insights": { ... },
  "data": {
    "daily": [
      {
        "date": "2026-01-15",
        "reddit_mentions": 245,
        "reddit_sentiment": 72,
        "stocktwits_mentions": 189,
        "twitter_followers": 25400000,
        "instagram_followers": 14200000,
        "ios_downloads": 12500,
        "android_downloads": 18200,
        "job_posts": 1250,
        "financials": {
          "price": 248.50,
          "target_price": 275.00,
          "market_cap": 785000000000
        },
        "ai_scores": {
          "score": 78,
          "audience": 82,
          "employment": 71,
          "customer": 85,
          "fundamental": 74
        }
      }
    ],
    "monthly": [
      {
        "date": "2026-01-01",
        "webtraffic": 125000000,
        "employer_rating_overall": 78,
        "employee_business_outlook": 65
      }
    ]
  }
}

Daily Data Fields

Field	Type	Description
`date`	string	Date (YYYY-MM-DD)
`reddit_mentions`	integer	Reddit mention count
`reddit_sentiment`	integer	Reddit sentiment score (0-100)
`stocktwits_mentions`	integer	Stocktwits mention count
`twitter_followers`	integer	Twitter/X follower count
`instagram_followers`	integer	Instagram follower count
`facebook_fans`	integer	Facebook fan count
`youtube_subscribers`	integer	YouTube subscriber count
`tiktok_followers`	integer	TikTok follower count
`ios_downloads`	integer	iOS app downloads
`android_downloads`	integer	Android app downloads
`app_downloads`	integer	Average of iOS and Android downloads
`jobs_glassdoor`	integer	Glassdoor job postings
`jobs_linkedin`	integer	LinkedIn job postings
`job_posts`	integer	Average of Glassdoor and LinkedIn job posts
`employees_linkedin`	integer	LinkedIn employee count
`financials`	object	Financial metrics (price, target_price, market_cap, pe_ratio)
`ai_scores`	object	AI scores (score, audience, employment, customer, fundamental)

Monthly Data Fields

Field	Type	Description
`date`	string	Date (YYYY-MM-DD)
`webtraffic`	integer	Estimated monthly web visitors
`employer_rating_overall`	integer	Glassdoor overall rating (0-100)
`employee_business_outlook`	integer	Glassdoor business outlook (0-100)

GET /ticker GET /industry_benchmark