← LeaderboardThe Skill Leaderboard

eric-education-api

Search 2M+ education research records via the ERIC database API

Published by brycewang-stanford ↗brycewang-stanford/Auto-Empirical-Research-Skills

Try your first task

eric-education-api

Start a fresh conversation. Replace the highlighted placeholders.

Use eric-education-api to search ERIC for [education topic], applying [date range] and [desired filters], and return a concise, linked list of the most relevant records with titles, authors, years, abstracts, descriptors, and ERIC IDs.

Required inputs

  • [education topic]
  • [date range]
  • [desired filters]

User-approved starter prompt based on a pinned source version; check current skill requirements before running. Task evidence ↗

SKILL.md

name: eric-education-apidescription: "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

# 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

ParameterDescriptionExample
searchFree-text or field searchsearch=adaptive+learning
formatResponse formatjson or xml
rowsResults per page (max 200)rows=50
startPagination offsetstart=50
publicationtypeDocument typeJournal Articles, Reports, Dissertations/Theses
publicationdatestartFrom date2024-01-01
publicationdateendTo date2026-12-31
peerreviewedPeer-reviewed filtertrue or false
descriptorERIC thesaurus termdescriptor:"Distance Education"
educationlevelEducation levelHigher Education, Elementary Education
subjectSubject areasubject:"Mathematics Education"

Search Fields

FieldDescription
titleArticle title
authorAuthor name
descriptorERIC controlled vocabulary term
sourceJournal/source name
abstractAbstract text
idERIC document ID (e.g., EJ1234567)

Publication Types

TypeDescription
Journal ArticlesPeer-reviewed journal articles
Reports - ResearchResearch reports
Reports - DescriptiveDescriptive reports
Reports - EvaluativeProgram evaluations
Dissertations/ThesesGraduate research
Speeches/Meeting PapersConference presentations
BooksBooks and book chapters

Response Structure

{
  "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

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:

DescriptorCoverage
Distance EducationOnline/remote learning
Educational TechnologyEdTech tools and methods
Higher EducationUniversity-level education
STEM EducationScience, technology, engineering, math
Teacher EducationTeacher training and development
AssessmentTesting and evaluation
Curriculum DevelopmentCurriculum design
Special EducationInclusive education

References

eric-education-api by brycewang-stanford · The Skill Leaderboard