Data Dictionary
A data dictionary explains what every variable name and value in a dataset actually means. This section provides formal definitions, allowed value ranges, and descriptions for every field returned by the AltIndex API, so you can integrate with confidence and interpret results correctly.
How to Read the Dictionary Tables
Each dataset page contains tables with the following columns:
| Column | Purpose |
|---|---|
| Variable Name | The exact field name as it appears in the API JSON response |
| Type | Data type (string, integer, float, date, object, array) |
| Allowed Values | Range, enumeration, or format constraint for valid values |
| Definition | A concise, formal definition of the variable |
| Description | Extended explanation with platform-specific notes, edge cases, and context |
Null handling: Social metric fields are nullable. When a metric is not available for a given platform or date, the field is omitted from the response rather than returned as null. See the API Reference for the platform-metric availability matrix.
Datasets
Entities
Company and entity metadata returned by the GET /api/entities and GET /api/entities/{ticker} endpoints. Includes ticker symbols, company names, industry classifications, and the social handle mappings behind the handle-backed audience metrics. Handle mappings gate those audience counts only, not mention and sentiment coverage, and not Stocktwits, which is keyed by cashtag.
Social Followers
Daily follower and subscriber counts across 9 social platforms: Instagram, X (Twitter), Facebook, Threads, TikTok, Pinterest, YouTube, Reddit, and Stocktwits. Returned by the GET /api/social/{platform}/{ticker} endpoints.
Mentions & Sentiment
Mention counts and sentiment scores derived from public discussion data on Reddit, Stocktwits, and X (Twitter). Returned by the GET /api/social/{platform}/{ticker} endpoints.
Data Coverage
Social Followers
Daily follower / subscriber counts for company-linked social accounts across 9 platforms.
| Platform | Metric |
|---|---|
| Follower count | |
| Page like count | |
| X (Twitter) | Follower count |
| Threads | Follower count |
| TikTok | Follower count |
| Follower count | |
| YouTube | Subscriber count |
| Subreddit member count | |
| Stocktwits | Cashtag watcher count |
Social Mentions & Sentiment
Mention counts and sentiment scores derived from public discussion data.
| Source | Metrics |
|---|---|
| Mention counts + sentiment (posts & comments across investing subreddits) | |
| Stocktwits | Daily mention counts + sentiment |
| X (Twitter) | Cashtag mention counts + sentiment |
Events & Filings
Record-level datasets alongside the daily signals. Counts and dates are measured against the production database; see Collection & Freshness for the full per-dataset catalogue.
| Dataset | Records | History begins | Newest record |
|---|---|---|---|
| News Articles | 2.3M+ | 2010-03-04 | 2026-08-31 |
| Insider Transactions | 294K+ | 2020-06-10 | 2026-08-28 |
| Congressional Trades | 40K+ | 2021-09-15 | 2026-08-28 |
| Quarterly Fundamentals | 187K+ | 2002-10-30 | 2026-08-28 |
Coverage Summary
| Metric | Value |
|---|---|
| Entities covered | ~2,958 (stocks, ETFs, and crypto) |
| Historical depth | 7+ years (since Oct 2018) |
| Timeline records | 7.2M+ |
| Social platforms | 9 |
| Reddit mentions tracked | 747,243+ |
| Figures measured on | 2026-08-31 |
Company entities and their social handle mappings are available through the GET /api/entities and GET /api/entities/{ticker} endpoints. See Knowledge Graph for details on how we map tickers to social accounts.
Related Pages
- Knowledge Graph: How tickers are mapped to social accounts and platform identifiers
- Collection & Freshness: Update frequency and historical depth per metric