# Sleeper Fantasy NFL Trending Players Scraper (`parseforge/sleeper-fantasy-nfl-scraper`) Actor

Collects Sleeper Fantasy NFL trending player adds or drops over a configurable lookback window and returns each player as a flat row with trend count and player ID.

- **URL**: https://apify.com/parseforge/sleeper-fantasy-nfl-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Automation, Developer tools, Other
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.80 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### Sleeper Fantasy NFL Trending Players Scraper

**Scrape Sleeper fantasy NFL trending players, most added or most dropped, with add/drop counts and player details.** Get the players your league is chasing or cutting, ranked over any lookback window from 1 to 168 hours. No login, no API key. Export to CSV, JSON, Excel, or XML.

Sleeper's public fantasy API returns raw trend IDs, but turning them into actionable player data means extra calls and joins. This Actor pulls the trending adds or drops for NFL fantasy football, enriches each player with their name, position, team, and add/drop counts, and returns one flat row per player. It is built for waiver-wire research, trade analysis, and league-mate behavior tracking.

| Who uses it | What they scrape Sleeper for |
|---|---|
| Fantasy football managers | Which players to target on the waiver wire this week |
| DFS players | Which players are gaining or losing roster share before lock |
| Fantasy analysts | Which adds and drops are moving the market across leagues |
| Sports bettors | Which player trends signal public sentiment shifts |

### What it does

This Actor collects Sleeper NFL trending players by add or drop trend, enriches them with player details, and returns each player as one flat row.

- 📈 **Most added:** the players fantasy managers are adding to rosters right now, ranked by add count over your lookback window.
- 📉 **Most dropped:** the players being cut most, ranked by drop count over the same window.
- ⏱️ **Configurable lookback:** set any window from 1 to 168 hours to catch short-term spikes or longer trends.
- 🔢 **Trend limit:** request up to 200 trending players from Sleeper before enrichment, so you control the candidate pool.
- 📦 **Flat output:** every player comes back as one row with name, position, team, and add/drop counts, ready for CSV or a spreadsheet.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with Sleeper data

**🏈 Waiver wire targets.**

A fantasy manager runs the Actor for most added players over the last 24 hours to see who is being picked up before waivers clear.

**📉 Drop candidates.**

A manager checks most dropped players over 48 hours to decide which of their own players are losing trust across leagues.

**📊 Market sentiment.**

An analyst pulls both add and drop trends over a week to compare roster churn and write a weekly waiver column.

**💰 DFS ownership shifts.**

A DFS player monitors adds over the last few hours before lock to spot chalk and pivot options.

### Why choose this scraper

| | What you get |
|---|---|
| **No API key** | Reads Sleeper's public JSON endpoints directly, no registration or OAuth. |
| **Enriched players** | Each trend row includes player name, position, team, and add/drop counts. |
| **Flexible lookback** | Rank trends over 1 to 168 hours to match your waiver or DFS window. |
| **Add or drop** | Switch between most added and most dropped with one input. |

### How it compares

This Actor focuses on enriched NFL trending players, while the competitors below either return raw IDs or cover broader Sleeper data.

| Feature | ParseForge | Sleeper NFL Trending Players Scraper - Fantasy Data | Sleeper Fantasy Sports Scraper |
|---|---|---|---|
| Enriched player details (name, position, team) | Yes | Not listed | Yes |
| Add/drop counts | Yes | Yes | Yes |
| Configurable lookback window | Yes | Yes | Not listed |
| Trend limit control | Yes | Not listed | Not listed |
| NFL only | Yes | Yes | Not listed |
| No login required | Yes | Not listed | Yes |

### Configure the run

Drive the Actor with a trend type, a lookback window in hours, and a trend limit, and it returns the top trending players with their details. The Input tab lists every parameter.

A first run with the defaults:

```json
{
 "maxItems": 10
}
```

A larger pull:

```json
{
 "maxItems": 200
}
```

### Pricing

Pay-per-result: **$0.001 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $0.10 |
| 1,000 results | $1.00 |
| 10,000 results | $10.00 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [Sleeper Fantasy NFL Trending Players Scraper](https://apify.com/parseforge/sleeper-fantasy-nfl-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to Sleeper through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/sleeper-fantasy-nfl-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Check that your lookback\_hours is within 1 to 168 and your trend limit is at least 1. Sleeper may return fewer players than requested if there is not enough activity in that window.

**Why are some players missing details like position or team?**

Sleeper's trend endpoint returns player IDs, and the Actor enriches them from the player database. If a player is very new or has been removed, some fields may be blank.

**Why did I get fewer players than maxItems?**

maxItems is the maximum number of players to collect, but the actual count is limited by the trend limit and what Sleeper returns. Increase trend limit if you need more candidates.

**Can I get historical trends?**

No, the Actor only returns current trending data from Sleeper's live API. To track changes over time, schedule regular runs and store the results.

### FAQ

| Question | Answer |
|---|---|
| Do I need a Sleeper API key or login? | No. The Actor reads Sleeper's public JSON endpoints, so no authentication is required. |
| What is the difference between add and drop trends? | Add returns the players most added to fantasy rosters in the lookback window. Drop returns the players most dropped. |
| What does lookback\_hours control? | It sets the time window in hours used to rank the trend. For example, 24 ranks adds or drops over the last day, while 168 covers a full week. |
| How many players can I get per run? | You can set maxItems up to 1,000,000, but the actual number returned is limited by the trend limit and how many players Sleeper returns. |
| What player details are included? | Each row includes the player's name, position, team, and add or drop count, along with the trend type and lookback window used. |
| Can I get both add and drop trends in one run? | No, each run returns one trend type. Run the Actor twice with type set to add and then drop to get both. |
| Is this only for NFL? | Yes, this Actor is built for Sleeper NFL fantasy football. For basketball or other sports, use a different scraper. |
| What export formats are supported? | You can export the results to CSV, JSON, Excel, or XML from the Apify dataset. |
| How fresh is the data? | The Actor pulls live data from Sleeper's public API at the time of the run, so it reflects the current trending rankings. |
| Can I schedule this to run automatically? | Yes, you can set up a schedule in Apify to run the Actor at intervals, such as every hour or every day before waivers clear. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Sleeper, Inc. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

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

Choose which trend to pull from Sleeper. Add returns the players most added to fantasy rosters. Drop returns the players most dropped.

## `lookback_hours` (type: `integer`):

Time window in hours used to rank the trend. A value of 24 ranks adds or drops over the last day. Larger windows surface longer running trends.

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

How many trending players to request from Sleeper before enrichment. The default of 25 reliably yields more than five enriched records.

## `maxItems` (type: `integer`):

How many players to collect per run.

## Actor input object example

```json
{
  "type": "add",
  "lookback_hours": 24,
  "limit": 25,
  "maxItems": 10
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/sleeper-fantasy-nfl-scraper").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 = { "maxItems": 10 }

# Run the Actor and wait for it to finish
run = client.actor("parseforge/sleeper-fantasy-nfl-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "maxItems": 10
}' |
apify call parseforge/sleeper-fantasy-nfl-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/sleeper-fantasy-nfl-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/rIHvVNEHNMpOrZir5/builds/7g13z2jTgTMO9UsWN/openapi.json