# 👑 Dividend Aristocrats — Kings, Achievers, Growth Stocks (`nexgendata/dividend-aristocrats-tracker`) Actor

Track S\&P 500 Dividend Aristocrats (25+yr increases), Dividend Kings (50+yr), and Achievers (10+yr) with current yield, payout ratio, dividend growth rate, consecutive years streak. Income-investor data for DGI strategies, family offices, dividend ETFs. Pay-per-result.

- **URL**: https://apify.com/nexgendata/dividend-aristocrats-tracker.md
- **Developed by:** [NexGenData](https://apify.com/nexgendata) (community)
- **Categories:** Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $50.00 / 1,000 dividend stock records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Dividend Aristocrats Tracker — Kings, Achievers, Growth Stocks

Track the elite ranks of dividend-growth investing in one API call. **Dividend Kings** (50+ consecutive years of dividend increases), **S&P 500 Dividend Aristocrats** (25+ years AND S&P 500 membership), **Dividend Achievers** (10+ years), and **Dividend Contenders** (10-24 year streaks approaching Aristocrat status). Every record carries current price, market cap, dividend yield, payout ratio, annual dividend, forward P/E, 5-year dividend growth rate, the most recent increase percentage and date, the next ex-dividend date — and the headline streak metric: `consecutive_years_of_increases`.

Built for income-focused investors who care about *dividend growth*, not just dividend yield. Coca-Cola (KO) has raised its dividend every year since 1962. Procter & Gamble (PG) since 1957. Johnson & Johnson (JNJ) since 1962. American States Water (AWR) since 1955 — 69 years and counting. These aren't speculative bets; they're the bedrock of multi-generational compounders.

### Buyer pool

- **Dividend-growth investing (DGI) retail** — running yield-on-cost ladders, screening for new candidates as old streaks break
- **Income-focused retirees** — building portfolios that grow income faster than inflation
- **Family offices** — laddering yield across sectors with risk-adjusted dividend stability
- **Dividend-strategy ETF providers** — reconciling constituent universes, screening for index inclusion/exclusion (NOBL, SDY, SCHD, VIG, DGRO, RDVY)
- **Financial advisors & RIAs** — running quarterly client portfolio reviews against the canonical Aristocrats list
- **Wealth platforms / fintech apps** — embedding "DGI screen" features without paying for Bloomberg or FactSet seats

### What's in every record

| Field | Description |
|-------|-------------|
| `symbol` | NYSE/Nasdaq ticker (KO, PG, JNJ, MMM, …) |
| `company_name` | Full legal name |
| `sector` | GICS sector classification |
| `category` | Aristocrat / King / Achiever / Contender |
| `consecutive_years_of_increases` | Streak length — the headline metric |
| `current_price` | Latest market price (USD) |
| `market_cap_usd` | Market capitalization in USD |
| `dividend_yield_pct` | Current trailing yield |
| `annual_dividend_usd` | Indicated annual dividend per share |
| `payout_ratio_pct` | Dividend / earnings ratio — sustainability check |
| `most_recent_increase_pct` | Last announced raise (e.g. 4.2%) |
| `most_recent_increase_date` | When that raise was declared |
| `next_ex_dividend_date` | Upcoming ex-date — buy-by-this-date for the next payout |
| `forward_pe` | Forward price/earnings multiple |
| `5y_dividend_growth_rate_pct` | Annualized 5-year dividend CAGR |
| `as_of_date` | When this record was scraped |
| `source_url` | Direct deep link to the company page |

### Input filters

- `category` — Aristocrat / King / Achiever / Contender / all
- `limit` — cap on records (default 50; Aristocrats universe is ~70, Kings is ~50)
- `min_yield_pct` — drop names yielding below threshold (e.g. 2.5 for income strategies)
- `max_payout_ratio_pct` — drop names paying out more than (e.g.) 80% of earnings — sustainability filter
- `sector` — restrict to one GICS sector (Consumer Staples, Utilities, Industrials, …)
- `min_consecutive_years` — minimum streak length (10 = Achievers, 25 = Aristocrats, 50 = Kings)
- `fetch_live_quotes` — set to false for static universe-only mode (cheaper, faster)

### Example: hunt for Kings yielding 3%+ with payout ratios under 75%

```json
{
  "category": "King",
  "min_yield_pct": 3.0,
  "max_payout_ratio_pct": 75,
  "limit": 20
}
````

Returns the elite slice of Kings (50+yr streaks) that simultaneously offer institutional-grade current yield AND room for the dividend to keep growing without being squeezed by earnings.

### Example: Industrials Aristocrats with the longest streaks

```json
{
  "category": "Aristocrat",
  "sector": "Industrials",
  "min_consecutive_years": 30,
  "limit": 15
}
```

Returns Dover (DOV, 68yr), Emerson Electric (EMR, 67yr), Parker Hannifin (PH, 67yr), 3M (MMM, 66yr), Illinois Tool Works (ITW, 60yr), Nordson (NDSN, 61yr), W.W. Grainger (GWW, 53yr), Stanley Black & Decker (SWK, 56yr), Caterpillar (CAT, 31yr), and so on.

### How it works

1. Resolve the constituent universe for the requested category (curated from S\&P methodology, Wikipedia, Sure Dividend).
2. Apply pre-filters (sector, min\_consecutive\_years) BEFORE any live HTTP traffic — saves cost.
3. Sort by `consecutive_years_of_increases` descending — longest-streak names first.
4. For each surviving ticker, fetch the stock overview page + dividend history page concurrently from stockanalysis.com.
5. Extract current price, market cap, yield, payout ratio, annual dividend, forward P/E, 5y dividend CAGR, next ex-dividend date.
6. Compute the most recent increase percentage by comparing the two latest declared dividend amounts.
7. Apply post-enrichment filters (min\_yield\_pct, max\_payout\_ratio\_pct).
8. Push the record to the default dataset and bill the PPE event.

### Pricing

**Pay-per-result** — $0.01 actor start + $0.05 per dividend stock record. A full Aristocrats sweep (~70 names) costs ~$3.51. A targeted 20-name DGI screen costs ~$1.01. No subscription, no monthly minimums, no Bloomberg terminal.

### How this compares

| | This actor | Bloomberg Terminal | FactSet | Simply Safe Dividends | Sure Dividend Premium | Seeking Alpha Premium |
|---|---|---|---|---|---|---|
| Cost | ~$3 per Aristocrat sweep | $32,000/year/seat | $20,000+/year | $499/year | $99/year newsletter | $239/year |
| API access | Yes (Apify, JSON) | Yes (terminal + B-PIPE) | Yes | No | No | No |
| Streak data | Yes | Yes | Yes | Yes (proprietary scoring) | Yes (lists) | Limited |
| Real-time price | Yes | Yes | Yes | Delayed | No | Yes |
| Payout ratio + 5y growth | Yes | Yes | Yes | Yes | Yes | Limited |
| Most recent increase % | Yes | Yes (via DVD function) | Yes | Yes | No | No |
| Customizable filters | Yes (yield/payout/sector/streak) | Yes (heavy syntax) | Yes (heavy syntax) | Pre-built screens | Static PDF | Pre-built screens |
| Setup time | 60 seconds | Days (auth + training) | Days | Account creation | Email signup | Account creation |
| Buyer fit | DGI retail, RIAs, family offices, fintech, ETF research | Sell-side, institutional | Buy-side | DGI retail | DGI retail | DGI retail |

You're not replacing Bloomberg if you need cross-asset analytics, news, chat, and execution. You're replacing the *one workflow* where Bloomberg charges $32K/year — pulling the canonical DGI universe with current market data — for ~$3 per run.

### Data sources

- **S\&P Global** Aristocrats methodology — the authoritative inclusion criteria
- **Wikipedia** — "S\&P 500 Dividend Aristocrats" + "List of Dividend Kings" canonical lists
- **Sure Dividend** — Kings & Achievers/Contenders streak data
- **stockanalysis.com** — per-stock current price, market cap, dividend yield, payout ratio, forward P/E, 5y dividend growth rate, ex-dividend date, dividend history

### Quality notes

- **Streak data accuracy** — the constituent file in this actor is updated against Sure Dividend's bi-monthly streak reports. If a name cuts its dividend (the 2020 Wells Fargo / 2024 Walgreens situation), it's removed from the file in the next maintenance cycle.
- **Spin-off handling** — when a parent (Abbott) spins off a subsidiary (AbbVie), each company resets its streak per S\&P methodology. We follow S\&P's treatment.
- **Special dividends** — explicitly excluded. Only regular cash dividend increases count toward the streak.
- **Stock splits** — split-adjusted in dividend growth calculations.

### Cross-link to the NexGenData finance fleet

If you're using this actor you probably want the rest of the NexGenData income-investing stack:

- **[Finviz Stock Screener](https://apify.com/nexgendata/finviz-stock-screener)** — apply 70+ Finviz filters (yield, payout, beta, P/E, sector) to the broader US universe
- **[ETF Holdings Tracker](https://apify.com/nexgendata/etf-holdings-tracker)** — pull constituent holdings & weights for NOBL, SDY, SCHD, VIG, DGRO and 100+ other ETFs
- **[Earnings Calendar](https://apify.com/nexgendata/earnings-calendar)** — get earnings dates for every Aristocrat in your portfolio
- **[Analyst Price Targets](https://apify.com/nexgendata/analyst-price-targets)** — Wall Street consensus on each Aristocrat
- **[Treasury Yields & Bonds](https://apify.com/nexgendata/treasury-yields-bonds)** — compare dividend yields vs the risk-free curve to size your equity income allocation
- **[Finance MCP Server](https://apify.com/nexgendata/finance-mcp-server)** — wrap this and the rest of the fleet under MCP for Claude/ChatGPT-driven income-portfolio research

### Affiliate

Get started with Apify and the NexGenData fleet: **https://apify.com/nexgendata?fpr=2ayu9b**

Use that link to spin up your first DGI screen in 60 seconds, then layer in ETF holdings, earnings dates, analyst targets, and treasury yields to build a complete income-portfolio research workflow.

# Actor input Schema

## `category` (type: `string`):

Which dividend-growth tier to pull. 'King' = 50+ consecutive years of dividend increases (rarest, ~50 names — KO, PG, JNJ, MMM, CINF). 'Aristocrat' = 25+ years AND member of the S\&P 500 (~70 names — the canonical DGI universe). 'Achiever' = 10+ years (~350 names — wider opportunity set including future Aristocrats). 'Contender' = 10-24 years specifically (subset of Achievers approaching Aristocrat status). 'all' merges every tier and de-duplicates by ticker, ranking by consecutive\_years\_of\_increases descending.

## `limit` (type: `integer`):

Hard cap on the number of dividend stock records emitted. Aristocrats and Kings universes are small (~70 and ~50 names respectively) so set 0 to fetch everything. Achievers and Contenders are larger — cap at 50-100 for cost control. Records are sorted by consecutive\_years\_of\_increases (descending) so a low limit gives you the longest-streak names first.

## `min_yield_pct` (type: `number`):

Filter out names yielding below this threshold. Standard DGI screens use 2.0% as the floor (above the S\&P 500 average yield). Income-focused retirees often raise this to 3.0-4.0% (REITs, telecoms, utilities territory). Set 0 to disable the yield floor and capture low-yield-high-growth names like Lowe's (LOW) or Sherwin-Williams (SHW) where the growth rate matters more than current yield.

## `max_payout_ratio_pct` (type: `number`):

Filter out names with payout ratios above this ceiling. Standard sustainability check: 60% for industrials/consumer staples, 80% for utilities and telecoms, 90%+ for REITs (which must distribute 90% of taxable income by law). Set 0 to disable. Stocks with payout ratios above 100% are paying out more than they earn — typically funded by debt and an early warning of a dividend cut.

## `sector` (type: `string`):

GICS sector filter. Consumer Staples and Industrials dominate the Aristocrats list (think PG, KO, CL, EMR, MMM). Utilities and Real Estate skew toward higher yields. Healthcare names (JNJ, ABT, BDX) usually combine moderate yield with strong dividend growth. Set 'all' for the full universe across sectors.

## `min_consecutive_years` (type: `integer`):

Filter by the streak length. 10 = Achievers floor, 25 = Aristocrats floor, 40 = elite long-streak names approaching King status, 50 = Kings floor, 60+ = ultra-rare names like Procter & Gamble (PG, 67yr), Coca-Cola (KO, 62yr), Genuine Parts (GPC, 68yr), Dover (DOV, 68yr). Set 0 to disable the streak floor and rely on the category filter alone.

## `fetch_live_quotes` (type: `boolean`):

When true (default), the actor enriches each record by hitting stockanalysis.com/stocks/{symbol}/ for the current price, market cap, dividend yield, payout ratio, forward P/E, and 5-year dividend growth rate. When false, only the static constituent data (symbol, name, sector, category, consecutive\_years\_of\_increases) is emitted — faster and cheaper, but no live market data. Disable for bulk universe reconciliation or backtest setup.

## Actor input object example

```json
{
  "category": "Aristocrat",
  "limit": 50,
  "min_yield_pct": 0,
  "max_payout_ratio_pct": 0,
  "sector": "all",
  "min_consecutive_years": 0,
  "fetch_live_quotes": true
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "category": "Aristocrat",
    "limit": 50,
    "min_yield_pct": 0,
    "max_payout_ratio_pct": 0,
    "sector": "all",
    "min_consecutive_years": 0,
    "fetch_live_quotes": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexgendata/dividend-aristocrats-tracker").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "category": "Aristocrat",
    "limit": 50,
    "min_yield_pct": 0,
    "max_payout_ratio_pct": 0,
    "sector": "all",
    "min_consecutive_years": 0,
    "fetch_live_quotes": True,
}

# Run the Actor and wait for it to finish
run = client.actor("nexgendata/dividend-aristocrats-tracker").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "category": "Aristocrat",
  "limit": 50,
  "min_yield_pct": 0,
  "max_payout_ratio_pct": 0,
  "sector": "all",
  "min_consecutive_years": 0,
  "fetch_live_quotes": true
}' |
apify call nexgendata/dividend-aristocrats-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=nexgendata/dividend-aristocrats-tracker",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "👑 Dividend Aristocrats — Kings, Achievers, Growth Stocks",
        "description": "Track S&P 500 Dividend Aristocrats (25+yr increases), Dividend Kings (50+yr), and Achievers (10+yr) with current yield, payout ratio, dividend growth rate, consecutive years streak. Income-investor data for DGI strategies, family offices, dividend ETFs. Pay-per-result.",
        "version": "0.0",
        "x-build-id": "1n9TshjL4LtdMHCrL"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/nexgendata~dividend-aristocrats-tracker/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-nexgendata-dividend-aristocrats-tracker",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/nexgendata~dividend-aristocrats-tracker/runs": {
            "post": {
                "operationId": "runs-sync-nexgendata-dividend-aristocrats-tracker",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/nexgendata~dividend-aristocrats-tracker/run-sync": {
            "post": {
                "operationId": "run-sync-nexgendata-dividend-aristocrats-tracker",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "category": {
                        "title": "Dividend category",
                        "enum": [
                            "Aristocrat",
                            "King",
                            "Achiever",
                            "Contender",
                            "all"
                        ],
                        "type": "string",
                        "description": "Which dividend-growth tier to pull. 'King' = 50+ consecutive years of dividend increases (rarest, ~50 names — KO, PG, JNJ, MMM, CINF). 'Aristocrat' = 25+ years AND member of the S&P 500 (~70 names — the canonical DGI universe). 'Achiever' = 10+ years (~350 names — wider opportunity set including future Aristocrats). 'Contender' = 10-24 years specifically (subset of Achievers approaching Aristocrat status). 'all' merges every tier and de-duplicates by ticker, ranking by consecutive_years_of_increases descending.",
                        "default": "Aristocrat"
                    },
                    "limit": {
                        "title": "Maximum records to return",
                        "minimum": 0,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Hard cap on the number of dividend stock records emitted. Aristocrats and Kings universes are small (~70 and ~50 names respectively) so set 0 to fetch everything. Achievers and Contenders are larger — cap at 50-100 for cost control. Records are sorted by consecutive_years_of_increases (descending) so a low limit gives you the longest-streak names first.",
                        "default": 50
                    },
                    "min_yield_pct": {
                        "title": "Minimum dividend yield (%)",
                        "minimum": 0,
                        "maximum": 25,
                        "type": "number",
                        "description": "Filter out names yielding below this threshold. Standard DGI screens use 2.0% as the floor (above the S&P 500 average yield). Income-focused retirees often raise this to 3.0-4.0% (REITs, telecoms, utilities territory). Set 0 to disable the yield floor and capture low-yield-high-growth names like Lowe's (LOW) or Sherwin-Williams (SHW) where the growth rate matters more than current yield.",
                        "default": 0
                    },
                    "max_payout_ratio_pct": {
                        "title": "Maximum payout ratio (%)",
                        "minimum": 0,
                        "maximum": 200,
                        "type": "number",
                        "description": "Filter out names with payout ratios above this ceiling. Standard sustainability check: 60% for industrials/consumer staples, 80% for utilities and telecoms, 90%+ for REITs (which must distribute 90% of taxable income by law). Set 0 to disable. Stocks with payout ratios above 100% are paying out more than they earn — typically funded by debt and an early warning of a dividend cut.",
                        "default": 0
                    },
                    "sector": {
                        "title": "Sector filter",
                        "enum": [
                            "all",
                            "Consumer Staples",
                            "Consumer Discretionary",
                            "Industrials",
                            "Healthcare",
                            "Financials",
                            "Information Technology",
                            "Utilities",
                            "Energy",
                            "Materials",
                            "Real Estate",
                            "Communication Services"
                        ],
                        "type": "string",
                        "description": "GICS sector filter. Consumer Staples and Industrials dominate the Aristocrats list (think PG, KO, CL, EMR, MMM). Utilities and Real Estate skew toward higher yields. Healthcare names (JNJ, ABT, BDX) usually combine moderate yield with strong dividend growth. Set 'all' for the full universe across sectors.",
                        "default": "all"
                    },
                    "min_consecutive_years": {
                        "title": "Minimum consecutive years of dividend increases",
                        "minimum": 0,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Filter by the streak length. 10 = Achievers floor, 25 = Aristocrats floor, 40 = elite long-streak names approaching King status, 50 = Kings floor, 60+ = ultra-rare names like Procter & Gamble (PG, 67yr), Coca-Cola (KO, 62yr), Genuine Parts (GPC, 68yr), Dover (DOV, 68yr). Set 0 to disable the streak floor and rely on the category filter alone.",
                        "default": 0
                    },
                    "fetch_live_quotes": {
                        "title": "Fetch live price/yield/payout from stockanalysis.com",
                        "type": "boolean",
                        "description": "When true (default), the actor enriches each record by hitting stockanalysis.com/stocks/{symbol}/ for the current price, market cap, dividend yield, payout ratio, forward P/E, and 5-year dividend growth rate. When false, only the static constituent data (symbol, name, sector, category, consecutive_years_of_increases) is emitted — faster and cheaper, but no live market data. Disable for bulk universe reconciliation or backtest setup.",
                        "default": true
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
