About this Project

About this Project

The best policy decisions are those based on evidence and fact. Despite rapid growth in the availability of information, however, education policy has historically been driven by personal experience and politics. By making the abundance of PK–12 and higher education data easier than ever to access and analyze, we hope to change that.

This site draws on data from a number of sources, harmonizing variables and documentation to make it easier to look at trends and combine data. We will continue to add datasets, including data beyond education that help capture the full picture of students’ lives. We also plan to release a user-friendly interface, making it easier for anyone, regardless of statistical training, to access this rich repository of information. Ultimately, we hope this site will make it easier for researchers, practitioners, and policymakers to generate rigorous, accurate, and actionable insights to improve outcomes for students.

Data sources

Currently Available

Available Soon

How to use this API

Users can access this application programming interface (API) by directly hitting a URL endpoint or by using Stata or R.

Direct access

The general form of an API call is as follows:

https://ed-data-portal.urban.org/api/v1/{topic}/{source}/{endpoint}/{year}/[additional_specifiers _or_disaggregators]/[optional filters]
For example, if you want to request Common Core of Data school directory data for 2013, that URL would look like this:
https://ed-data-portal.urban.org/api/v1/schools/ccd/directory/2013/
Data are returned in JSON format.

Certain variables (indicated in the documentation with a green “FILTER” tag) can be used to subset or filter the data by appending a querystring to the end of the URL. Querystrings take the form ?filter_variable=filter_value. To include multiple filters, separate them with an &. For example, if you were interested only in charter schools in the District of Columbia, you could make the following call:

https://ed-data-portal.urban.org/api/v1/schools/ccd/directory/2013/?charter=1&fips=11

Some endpoints require specifiers or disaggregators. For example, for Common Core of Data enrollment, you must specify a grade:

https://ed-data-portal.urban.org/api/v1/schools/ccd/enrollment/2013/grade-3/

In addition, if you would like these data broken down by race, you would access this URL:

https://ed-data-portal.urban.org/api/v1/schools/ccd/directory/2013/grade-3/race/

All endpoints can be viewed directly in a web browser. If you’d like to programmatically access these data, this documentation includes examples of how to access data in Stata, R, Python, and JavaScript. Descriptions of the Stata and R packages are below, but the Python and JavaScript examples directly access endpoint URLs via the urllib library in Python and via an XMLHttpRequest object in JavaScript.

Stata

Instead of using API calls, you can download our Stata package using the instructions below.

The following command will install, or if the package is already installed, update the education data package:

net install educationdata, replace from("https://urbaninstitute.github.io/education-data-package-stata/")

For more information, or to troubleshoot, please visit github.com/UrbanInstitute/education-data-package-stata.

R

Alternatively, you can download our R package. To install educationdata:

Install the devtools package if you don't already have it, and run:

# install.packages('devtools') # if necessary
			devtools::install_github('UrbanInstitute/education-data-package-r')

For more information, or to troubleshoot, please visit github.com/UrbanInstitute/education-data-package-r.

Terms of Use

Visitors to this site agree to abide by the Urban Institute’s terms of service.

Permission is hereby granted, free of charge, to reuse the data and code (“the Content”) of the Education Data Portal for any noncommercial purpose provided that you maintain and abide by any notices, information, or restrictions contained therein, with attribution to the Education Data Portal and the Urban Institute. You may not, for your own financial gain/benefit, publish, display, reproduce, modify, transmit, participate in the transfer or sale of, create new works from, distribute, or in any way exploit any of the Content or the Services in whole or in part unless expressly authorized by Urban in writing. The Content is provided as is, without warranty of any kind, express or implied.

The Education Data Portal contains links to websites operated by organizations other than the Urban Institute. Urban is not responsible for the availability of these outside resources, their contents, any link contained in a linked site, or any changes or update to such a site. Urban provides these links only as a convenience, and the inclusion of any link does not imply or mean endorsement by the Urban Institute, the site, or its contents.

Acknowledgements

This project was funded by the Overdeck Family Foundation. We are grateful to them and to all our funders, who make it possible for Urban to advance its mission. The views expressed are those of the authors and should not be attributed to the Urban Institute, its trustees, or its funders. Funders do not determine research findings or the insights and recommendations of our experts. More information on our funding principles is available here. Read our terms of service here.

Contact us

We would love to hear from you! Please send us your feedback at educationdata@urban.org.