Eric Education ApiSAFE

🔬 A curated collection of 23,000+ agent skills for empirical research across 8 social science disciplines. | 精选 23,000+ AI Agent 技能库,覆盖8大社会科学学科的实证研究。CoPaper.AI 20分钟完成一篇可复现的规范实证论文,并支持用户上传 Skills。-- Maintained by CoPaper.AI from Stanford REAP.

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: eric-education-api
description: "Search 2M+ education research records via the ERIC database API"
metadata:
  openclaw:
    emoji: "🎓"
    category: "literature"
    subcategory: "search"
    keywords: ["ERIC", "education research", "IES", "pedagogy", "teaching", "educational technology"]
    source: "https://eric.ed.gov/"
---

# ERIC (Education Resources Information Center) API

## Overview

ERIC is the world's largest digital library of education research, sponsored by the U.S. Institute of Education Sciences (IES). It indexes 2M+ records including journal articles, reports, conference papers, and dissertations covering all aspects of education. The API provides free, unauthenticated access to metadata and links to full text where available.

## API Endpoints

### Base URL

```
https://api.ies.ed.gov/eric/
```

### Search

```bash
# Basic keyword search
curl "https://api.ies.ed.gov/eric/?search=online+learning&format=json&rows=20"

# Search in specific fields
curl "https://api.ies.ed.gov/eric/?search=title:\"blended learning\"&format=json"

# Filter by publication date
curl "https://api.ies.ed.gov/eric/?search=STEM+education&start=0&rows=25&\
publicationdatestart=2023-01-01&publicationdateend=2026-12-31&format=json"

# Filter by publication type
curl "https://api.ies.ed.gov/eric/?search=formative+assessment&\
publicationtype=Journal+Articles&format=json"

# Filter by descriptor (ERIC thesaurus term)
curl "https://api.ies.ed.gov/eric/?search=descriptor:\"Higher Education\"&format=json"

# Peer-reviewed only
curl "https://api.ies.ed.gov/eric/?search=metacognition&peerreviewed=true&format=json"
```

### Query Parameters

| Parameter | Description | Example |
|-----------|-------------|---------|
| `search` | Free-text or field search | `search=adaptive+learning` |
| `format` | Response format | `json` or `xml` |
| `rows` | Results per page (max 200) | `rows=50` |
| `start` | Pagination offset | `start=50` |
| `publicationtype` | Document type | `Journal Articles`, `Reports`, `Dissertations/Theses` |
| `publicationdatestart` | From date | `2024-01-01` |
| `publicationdateend` | To date | `2026-12-31` |
| `peerreviewed` | Peer-reviewed filter | `true` or `false` |
| `descriptor` | ERIC thesaurus term | `descriptor:"Distance Education"` |
| `educationlevel` | Education level | `Higher Education`, `Elementary Education` |
| `subject` | Subject area | `subject:"Mathematics Education"` |

### Search Fields

| Field | Description |
|-------|-------------|
| `title` | Article title |
| `author` | Author name |
| `descriptor` | ERIC controlled vocabulary term |
| `source` | Journal/source name |
| `abstract` | Abstract text |
| `id` | ERIC document ID (e.g., EJ1234567) |

### Publication Types

| Type | Description |
|------|-------------|
| `Journal Articles` | Peer-reviewed journal articles |
| `Reports - Research` | Research reports |
| `Reports - Descriptive` | Descriptive reports |
| `Reports - Evaluative` | Program evaluations |
| `Dissertations/Theses` | Graduate research |
| `Speeches/Meeting Papers` | Conference presentations |
| `Books` | Books and book chapters |

## Response Structure

```json
{
  "response": {
    "numFound": 8450,
    "start": 0,
    "docs": [
      {
        "id": "EJ1389012",
        "title": "Effects of AI Tutoring on Student Learning Outcomes",
        "author": ["Smith, John", "Chen, Wei"],
        "source": "Journal of Educational Technology",
        "publicationdateyear": 2024,
        "description": "This study examines the impact of AI-powered tutoring...",
        "descriptor": ["Artificial Intelligence", "Tutoring", "Academic Achievement"],
        "educationlevel": ["Higher Education"],
        "peerreviewed": "T",
        "url": "https://eric.ed.gov/?id=EJ1389012",
        "publicationtype": "Journal Articles",
        "issn": "1234-5678"
      }
    ]
  }
}
```

## Python Usage

```python
import requests

BASE_URL = "https://api.ies.ed.gov/eric/"


def search_eric(query: str, rows: int = 25,
                peer_reviewed: bool = True,
                pub_type: str = None,
                from_year: int = None) -> list:
    """Search the ERIC education research database."""
    params = {
        "search": query,
        "format": "json",
        "rows": rows,
    }
    if peer_reviewed:
        params["peerreviewed"] = "true"
    if pub_type:
        params["publicationtype"] = pub_type
    if from_year:
        params["publicationdatestart"] = f"{from_year}-01-01"

    resp = requests.get(BASE_URL, params=params)
    resp.raise_for_status()
    data = resp.json()

    results = []
    for doc in data.get("response", {}).get("docs", []):
        results.append({
            "id": doc.get("id"),
            "title": doc.get("title"),
            "authors": doc.get("author", []),
            "source": doc.get("source"),
            "year": doc.get("publicationdateyear"),
            "abstract": doc.get("description", "")[:300],
            "descriptors": doc.get("descriptor", []),
            "level": doc.get("educationlevel", []),
            "url": doc.get("url"),
        })
    return results


def search_by_descriptor(descriptor: str, rows: int = 50) -> list:
    """Search using ERIC thesaurus controlled vocabulary."""
    return search_eric(f'descriptor:"{descriptor}"', rows=rows)


# Example: find recent AI in education research
papers = search_eric("artificial intelligence classroom",
                     from_year=2023, rows=10)
for p in papers:
    print(f"[{p['year']}] {p['title']}")
    print(f"  Descriptors: {', '.join(p['descriptors'][:5])}")

# Example: search by ERIC descriptor
papers = search_by_descriptor("Gamification")
for p in papers:
    print(f"{p['id']}: {p['title']} — {p['source']}")
```

## ERIC Thesaurus

ERIC uses a controlled vocabulary of 12,000+ descriptors for consistent indexing. Key descriptors include:

| Descriptor | Coverage |
|------------|----------|
| `Distance Education` | Online/remote learning |
| `Educ

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.