US School Directory — NCES + Licensed GreatSchools API

Find US K–12 school records from the public NCES Common Core of Data directory, and optionally retrieve GreatSchools ratings and directory fields through your own authorized NearbySchools API agreement. This actor does not crawl, harvest, or scrape GreatSchools web pages.

Use cases

• Enrich a known list of NCES school IDs with directory fields.
• Retrieve schools around a coordinate through a licensed GreatSchools NearbySchools API key.
• Feed normalized school records into location intelligence, education research, or internal data pipelines.

Do not use it to collect GreatSchools content without an API agreement, create marketing-contact lists, or bypass GreatSchools access controls.

Input

NCES directory mode

The default mode accepts 12-digit NCES school IDs. This uses the public NCES-backed directory endpoint and needs no secret.

{
  "sourceMode": "nces",
  "ncesSchoolIds": ["010000500870"],
  "maxResults": 10
}

Authorized GreatSchools API mode

Create an Actor environment variable named GREAT_SCHOOLS_API_KEY in Apify Console using an API key issued under your NearbySchools agreement. Never supply that key as an actor input value.

{
  "sourceMode": "greatschoolsApi",
  "greatSchoolsLocation": {
    "latitude": 37.7940627,
    "longitude": -122.2680029,
    "distanceMiles": 5
  },
  "maxResults": 10
}

auto selects the GreatSchools API when a location is supplied; otherwise it selects NCES mode.

Output

Every record has a stable, agent-friendly shape. Fields unavailable from a source are null.

{
  "schoolName": "Alameda High School",
  "source": "greatschoolsApi",
  "ncesSchoolId": "060177000041",
  "greatSchoolsUniversalId": "0600001",
  "greatSchoolsRating": 10,
  "address": "2201 Encinal Avenue",
  "city": "Alameda",
  "state": "CA",
  "districtName": "Alameda Unified School District",
  "sourceUrl": "https://gs-api.greatschools.org/nearby-schools",
  "scrapedAt": "2026-07-22T12:00:00.000Z"
}

Pricing configuration

Before publishing, configure both Pay Per Event and Pay Per Usage in Apify Console. The included event contract contains:

Event	Suggested launch price
apify-actor-start	$0.00005/run
school-record-returned	$0.005/record

Enable compute-unit and proxy pass-through for Pay Per Usage. The GreatSchools API may separately charge under your agreement; choose a record price that preserves your required margin.

Compliance and data provenance

NCES mode uses directory data. GreatSchools values are made only through the documented API and your own credentials; GreatSchools web content is never scraped. You are responsible for ensuring your API agreement, data use, retention, attribution, and redistribution comply with the applicable provider terms and law.

MCP routing

Use this actor for structured US K–12 school directory records or for authorized NearbySchools API results. Do not use it for web-page scraping, reviews, parent contact details, enrollment applications, or any school outside the United States.