# Bleacher Report Articles Scraper (`parseforge/bleacher-report-articles-scraper`) Actor

Scrapes Bleacher Report articles by sports section and optional tag. Returns each article as a flat row with headline, author, timestamp, and full body text.

- **URL**: https://apify.com/parseforge/bleacher-report-articles-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Sports, News, Automation
- **Stats:** 2 total users, 1 monthly users, 89.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.50 / 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)

### Bleacher Report Articles Scraper

**Scrape Bleacher Report articles from any sports section, up to a million per run.** Each article comes with its headline, author, full body text, and publication date. No login or API key. Export to CSV, JSON, Excel, or XML.

Bleacher Report's website is built for browsers, not for bulk data collection. Manually copying articles from the NBA, NFL, or soccer sections is slow and error-prone. This Actor reads the public article feeds directly, filtered by sports section and optional team tag, and returns each match in one fixed schema.

| Who uses it | What they scrape Bleacher Report for |
|---|---|
| Sports journalists | Monitoring breaking news and story angles across major leagues. |
| Fantasy sports analysts | Gathering player mentions and injury reports for weekly projections. |
| Content marketers | Curating trending sports topics for social media and newsletters. |
| Data scientists | Building datasets for sports sentiment analysis and NLP models. |

### What it does

This Actor collects Bleacher Report articles by sports section and optional tag, and returns each one as a flat row.

- 🏀 **Section filter:** target a specific league like NBA, NFL, Soccer, MLB, NHL, or college sports.
- 🏷️ **Tag filter:** narrow results to a specific team or topic slug for focused collection.
- 📄 **Full article text:** the complete body content is extracted, not snippets or headlines.
- 📊 **Structured output:** every article returns as a clean row with headline, author, date, and body.

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

### What you can do with Bleacher Report data

**🏀 Monitor league-wide news.**

A sports reporter runs the Actor on the NBA section each morning to catch every story filed overnight and spot developing narratives before the competition.

**📈 Feed a fantasy sports model.**

A fantasy analyst scrapes the NFL section with a team tag to collect all mentions of a specific roster, feeding injury updates and coach quotes into a weekly projection spreadsheet.

**📰 Curate a daily newsletter.**

A content marketer pulls the top articles from Soccer and World Football sections to populate a morning email blast with the biggest global football stories.

**🤖 Train a sports NLP classifier.**

A data scientist collects thousands of articles across MLB, NHL, and MMA to build a training corpus for a model that classifies article tone and subject.

### Why choose this scraper

| | What you get |
|---|---|
| **No API key needed** | Reads the public website, so you skip registration and rate-limit headaches. |
| **Fixed schema** | Every article lands in your dataset with the same predictable fields. |
| **Bulk collection** | Grab up to a million articles in a single run for large-scale analysis. |

### How it compares

No other Store actor targets Bleacher Report the same way, so the honest comparison is with the alternatives teams actually weigh.

| | Bleacher Report Articles Scraper | Build it in-house | By hand |
|---|---|---|---|
| Setup | Run it now, zero config | Days of engineering | None, but hours per pull |
| When Bleacher Report changes | Maintained for you | You fix it | You re-learn the page |
| Proxies, retries, anti-bot | Built in | Your problem | Browser only |
| Output | Fixed JSON schema, CSV/Excel export | Whatever you build | Copy-paste |
| Cost | Pay per result | Engineering time | Analyst hours |

### Configure the run

Drive the Actor from a sports section and an optional tag filter, and collection stops when the maximum article count is reached. The Input tab lists every parameter.

A first run with the defaults:

```json
{
 "maxItems": 10,
 "section": "nba"
}
```

A larger pull:

```json
{
 "maxItems": 200,
 "section": "nba"
}
```

### Pricing

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

| Results collected | Approximate cost |
|---|---|
| 100 results | $0.85 |
| 1,000 results | $8.50 |
| 10,000 results | $85.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 [Bleacher Report Articles Scraper](https://apify.com/parseforge/bleacher-report-articles-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 Bleacher Report 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/bleacher-report-articles-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 the section slug is spelled correctly and matches one of the available options. If you used a tag filter, try removing it to see if the section itself returns articles.

**The run stopped before reaching my max items.**

The section feed likely ran out of articles. Bleacher Report sections paginate only so far back. Try a different section or remove the tag filter to broaden the pool.

**Some article bodies are truncated or missing.**

A small number of articles may be behind dynamic loading or paywalls. The Actor extracts what is available in the initial page HTML. Re-running later sometimes resolves this if the content was temporarily unavailable.

**The Actor is running slowly.**

The Actor respects the website's response times to avoid being blocked. For large runs, increase the timeout or run during off-peak hours. The speed is consistent with polite scraping.

### FAQ

| Question | Answer |
|---|---|
| Can I scrape multiple sections at once? | One section per run. To collect from several sections, run the Actor multiple times with different section inputs, or use a separate orchestrator Actor. |
| What does the tag filter do? | It filters articles by a team or topic slug. For example, entering 'lakers' in the NBA section returns only articles tagged with that team. |
| Is the full article body included? | Yes. The Actor extracts the complete body text of each article, not the headline or a preview snippet. |
| How many articles can I get in one run? | You set the maximum with the 'Maximum articles' input, up to 1,000,000 per run. The Actor stops when it reaches that count or exhausts the section. |
| Do I need a Bleacher Report account? | No. The Actor reads the publicly available article feeds, so no login, password, or API key is required. |
| What export formats are supported? | Your dataset can be exported to CSV, JSON, Excel, or XML from the Apify platform. |
| Can I filter by date range? | The Actor collects articles in the order they appear on the section feed. There is no date-range input, but you can stop the run after a certain count to approximate a recent window. |
| Does it scrape videos or multimedia? | The Actor focuses on article text and metadata. It does not download video files or extract embedded media beyond what is in the body text. |
| What sections are available? | NBA, NFL, Soccer, MLB, NHL, College Football, College Basketball, MMA, WWE, and World Football. |
| Is this faster than the Bleacher Report API? | Bleacher Report does not offer a public article API. This Actor reads the website directly, so it is the only automated way to collect articles at scale. |

### 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 Bleacher Report, 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

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

How many articles to collect per run.

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

Bleacher Report section (e.g. nba, nfl, soccer, mlb).

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

Optional tag or team slug filter.

## Actor input object example

```json
{
  "maxItems": 10,
  "section": "nba"
}
```

# 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,
    "section": "nba"
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/bleacher-report-articles-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,
    "section": "nba",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/bleacher-report-articles-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,
  "section": "nba"
}' |
apify call parseforge/bleacher-report-articles-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/bleacher-report-articles-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/R7xGquFwafTKmiP2M/builds/dKn2MDQW9ArLNla54/openapi.json
