# ERIC Scraper (`dadhalfdev/eric-scraper`) Actor

Scrape education documents from eric.ed.gov. Use the same search filters as the site (keyword, author, subject, publication type, education level, year, peer review) or paste a URL — the URL wins when set.

- **URL**: https://apify.com/dadhalfdev/eric-scraper.md
- **Developed by:** [Marco Rodrigues](https://apify.com/dadhalfdev) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## ERIC Scraper

Want [ERIC](https://eric.ed.gov/) education documents in a spreadsheet? This scraper makes it easy.

Use **structured filters** — better for AI agents — **or** paste an **`input_url`**. When `input_url` is set it overrides the filters.

ERIC is the U.S. Department of Education library of journal articles, reports, and other education documents. This actor returns up to 2000 rows per run.

### 💡 Perfect for...

- **Education research:** Export journal articles, reports, and dissertations from ERIC.
- **Dashboards:** Track new documents on a subject without paging the site.
- **Literature reviews:** Slice the collection by author, subject, year, or peer review.
- **Data analysts:** Export structured rows with public document URLs.
- **🤖 AI Agents:** Power Claude, Cursor, Codex, the Hermes Agent, and OpenClaw workflows with live ERIC results.
- **📚 RAG Systems:** Feed titles, authors, and abstracts into retrieval pipelines.
- **🔗 AI Workflows:** Plug into LangChain, AutoGPT, CrewAI, and similar stacks.

### ✨ Why you'll love this scraper

- 🔗 **Input URL or Filters:** Paste an ERIC search or document URL, or pick the same filters as the site. `input_url` always wins when set.
- 🎯 **Website-Matched Filters:** Keyword, author, subject, publication type, education level, language, peer review, and year — the same controls as the ERIC search.
- 🌐 **Listing cards:** Title, authors, year, abstract, subject, publication type, and publisher.

### 📦 What's inside the data?

`id`, `url`, `title`, `authors`, `year`, `abstract`, `field_of_study`, `publication_type`, `publisher`, `education_level`, `audience`, `language`, `peer_reviewed`, `issn`, `isbn`, `sponsor`

### 🚀 Quick start

**Option A:** paste `https://eric.ed.gov/?q=reading`.
**Option B:** type a keyword, author, or subject and set `max_results`.

**Input Example (filters):**

```json
{
  "query": "reading",
  "publication_type": "Journal Articles",
  "peer_reviewed": true,
  "year_from": 2020,
  "max_results": 100
}
```

**Input Example (URL):**

```json
{
  "input_url": "https://eric.ed.gov/?q=reading",
  "max_results": 100
}
```

**Output Example:**

```json
{
  "id": "ED621142",
  "url": "https://eric.ed.gov/?id=ED621142",
  "title": "Report of the Commissioner of Education for the Year Ended June 30, 1916. Volume I",
  "authors": null,
  "year": 1916,
  "abstract": "Volume I begins with the Commissioner of Education's introduction and a general survey of education.",
  "field_of_study": "Educational Legislation; Urban Education; Rural Education",
  "publication_type": "Historical Materials; Reports - Descriptive",
  "publisher": "Office of Education, United States Department of the Interior.",
  "education_level": null,
  "audience": null,
  "language": "English",
  "peer_reviewed": false,
  "issn": null,
  "isbn": null,
  "sponsor": null
}
```

**Output fields:**

| Field | Description |
|-------|-------------|
| `id` | ERIC document id. |
| `url` | Public document page. |
| `title` | Document title. |
| `authors` | Authors when shown. |
| `year` | Publication year. |
| `abstract` | Abstract snippet. |
| `field_of_study` | Subjects and descriptors. |
| `publication_type` | Journal article, report, book, and so on. |
| `publisher` | Publisher or source. |
| `education_level` | Education level when shown. |
| `audience` | Audience when shown. |
| `language` | Document language. |
| `peer_reviewed` | Whether ERIC marks it peer reviewed. |
| `issn` | ISSN when shown. |
| `isbn` | ISBN when shown. |
| `sponsor` | Sponsor when shown. |

### 📋 Input reference

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `input_url` | string | No | — | ERIC search or document URL. Overrides every filter. |
| `query` | string | No | — | Same as the ERIC search box. Empty lists the public collection. |
| `author` | string | No | — | Author name. |
| `subject` | string | No | — | Subject or descriptor. |
| `publication_type` | dropdown | No | any | Journal articles, reports, books, dissertations, and the rest of the ERIC list. |
| `education_level` | dropdown | No | any | Early childhood through adult education. |
| `language` | dropdown | No | any | Document language. |
| `peer_reviewed` | boolean | No | `false` | Peer-reviewed documents only. |
| `year_from` | integer | No | — | Earliest publication year. |
| `year_to` | integer | No | — | Latest publication year. |
| `max_results` | integer | No | `50` | Maximum rows (`1`–`2000`). |

# Actor input Schema

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

Paste an ERIC search or document URL. Overrides every filter when set.

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

Same as the ERIC search box. Leave empty to list the whole public collection.

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

Author name, same as the ERIC author search.

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

Subject or descriptor, same as the ERIC subject search.

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

Same publication type list as ERIC.

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

Same education level filter as ERIC.

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

Document language.

## `peer_reviewed` (type: `boolean`):

Same as the ERIC peer-reviewed limit.

## `year_from` (type: `integer`):

Earliest publication year.

## `year_to` (type: `integer`):

Latest publication year.

## `max_results` (type: `integer`):

Maximum rows to return (1–2000).

## Actor input object example

```json
{
  "publication_type": "",
  "education_level": "",
  "language": "",
  "peer_reviewed": false,
  "max_results": 50
}
```

# Actor output Schema

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

Table view of scraped documents using the dataset 'overview' view.

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

All scraped documents from the default dataset without view transformation.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("dadhalfdev/eric-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("dadhalfdev/eric-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 '{}' |
apify call dadhalfdev/eric-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dadhalfdev/eric-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/v3vh0JPhson6eFGon/builds/Lbozh4K9nK9va235a/openapi.json