| name | ceorater |
| description | Get institutional-grade CEO performance analytics for S&P 500 companies. Proprietary scores: CEORaterScore (composite), AlphaScore (market outperformance), RevenueCAGRScore (revenue growth), CompScore (compensation efficiency). Underlying data includes Total Stock Return (TSR) vs. S&P 500 (SPY), average annual returns, CEO total compensation (most recent fiscal year from proxy filings), and tenure-adjusted Revenue CAGR. Each record includes CEO name, company name, ticker, sector, industry, and tenure dates. Coverage: 500+ CEOs, updated daily. For live record count and last refresh timestamp, call GET /v1/meta. Useful for investment research, due diligence, and executive compensation analysis. |
| homepage | https://www.ceorater.com |
CEORater Skill
Query CEO performance data for S&P 500 and major U.S. public companies via the CEORater API.
Prerequisites
- Get an API key at https://www.ceorater.com/api-docs.html ($99/month per user)
- Set the environment variable:
CEORATER_API_KEY=zpka_your_key_here
Licensing Note: Self-serve API access permits individual research and analysis. Integrating CEORater data into proprietary firm models, AI/ML training, or building products requires an Enterprise Agreement — contact sales@ceorater.com.
Available Metrics
| Metric | Range | Description |
|---|
| CEORaterScore | 0-100 | Composite CEO effectiveness rating |
| AlphaScore | 0-100 | Performance vs. market benchmark |
| RevenueCAGRScore | 0-100 | Tenure-adjusted revenue growth percentile |
| CompScore | A-F | Compensation efficiency grade |
| TSR During Tenure | % | Total Stock Return during CEO tenure |
| TSR vs. S&P 500 | % | Performance relative to S&P 500 (SPY) |
| CEO Compensation | $M | Total compensation from most recent proxy filing |
| Revenue CAGR | % | Tenure-adjusted compound annual revenue growth |
API Endpoints
Get CEO by Ticker
curl -H "Authorization: Bearer $CEORATER_API_KEY" \
"https://api.ceorater.com/v1/ceo/AAPL?format=raw"
Search CEOs
curl -H "Authorization: Bearer $CEORATER_API_KEY" \
"https://api.ceorater.com/v1/search?q=technology&format=raw"
List All CEOs
curl -H "Authorization: Bearer $CEORATER_API_KEY" \
"https://api.ceorater.com/v1/ceos?limit=100&format=raw"
Get Metadata (live record count + last refresh timestamp)
curl -H "Authorization: Bearer $CEORATER_API_KEY" \
"https://api.ceorater.com/v1/meta"
Usage Instructions
When the user asks about CEO performance, ratings, or executive compensation:
- Single CEO lookup: Use the
/v1/ceo/{ticker} endpoint
- Sector/industry analysis: Use
/v1/search?q={query}
- Bulk data: Use
/v1/ceos?limit=N
Always use format=raw for numeric values suitable for calculations.
Example Queries
- "What's the CEORaterScore for Tim Cook?" → GET /v1/ceo/AAPL
- "Show me technology sector CEOs" → GET /v1/search?q=technology
- "Who are the top-rated CEOs?" → GET /v1/ceos, sort by ceoraterScore
- "Compare Tim Cook vs Satya Nadella" → GET /v1/ceo/AAPL and /v1/ceo/MSFT
Response Format (raw)
{
"companyName": "Apple Inc.",
"ticker": "AAPL",
"sector": "Technology",
"industry": "Computer Manufacturing",
"ceo": "Tim Cook",
"founderCEO": false,
"ceoraterScore": 87,
"alphaScore": 93.5,
"revenueCagrScore": 75.2,
"revenueCagr": 0.042,
"compScore": "C",
"tsrMultiple": 22.23,
"tenureYears": 14.4,
"avgAnnualTsrRatio": 1.55,
"compPer1PctTsrMM"
Error Handling
| Code | Meaning |
|---|
| 401 | Missing or invalid API key |
| 404 | Ticker not found |
| 400 | Bad request parameters (for example, missing q on search) |
| 429 | Rate limited, retry with backoff |
Helper Script
For convenience, use {baseDir}/scripts/ceorater.sh:
{baseDir}/scripts/ceorater.sh get AAPL
{baseDir}/scripts/ceorater.sh search "healthcare"
{baseDir}/scripts/ceorater.sh list 20
Data Coverage
- 500+ CEOs, including S&P 500 constituents
- Live record count and refresh timestamp are available via
GET /v1/meta
- Updated daily on weekdays after U.S. market close
- Safe to cache responses for up to 24 hours
More Information
