How to use the data
From the catalog
to your project.
Build something useful with the data. Try a project below, open a real file, or make your first API request. You can do all three before buying a pass.
Preview before you buy. No account needed.
U.S. states
Open it in a spreadsheet to see the columns and try sorting or filtering the records.
| State name | Abbreviation |
|---|---|
| Alabama | AL |
| Alaska | AK |
| Arizona | AZ |
The complete dataset, without a pass. See what’s included and where it came from.
Pick something you want to make
Start with a project guide.
Try a worked example with complete free data, then build your own version.
Developers & science classrooms JSON
Draw a periodic table
Turn one free API call into an interactive periodic table, then copy every line of the code that draws it.
A working table, its JavaScript, and a one-file download.
Explore this projectHistory classrooms & data learners CSV
Remember Titanic's passengers and crew
Read the lives behind the records, with a memorial roll and careful explanations of the counts.
A searchable roll, respectful charts, and a complete reference file.
Explore this projectSports fans & spreadsheet explorers CSV
Chart World Series champions
Build a pivot chart from baseball history, with a clear distinction between a team name and a franchise.
Every season, franchise totals, and a repeatable spreadsheet workflow.
Explore this projectFor spreadsheets and everyday work
Your first download
Need a different shape after downloading? Convert CSV to JSON, or copy one column into the comma separator tool to make a separated list. These free tools process your input in your browser.
Find the right list.
Browse the catalog or search for a subject. Check the preview, description, and sources to see whether the dataset covers what you need.
Try it in your project.
Use the free file links below the preview. You get up to 10 records from most datasets, so you can check the fields and format before buying a pass.
Download the complete dataset.
For a dataset that needs a pass, open Already have a pass? under Get the data. Paste the key from your purchase email, choose a format, and select Download complete dataset.
CSV
For Excel, Google Sheets, and other spreadsheet tools.
JSON
For applications, scripts, and web projects.
XML
For applications and import tools that require XML.
Keep leading zeros: import codes as text when zeros at the start are part of the value. Otherwise, a spreadsheet may turn a code such as 001 into 1.
What’s free, and what a pass adds
Every dataset used in our project guides is free in full, including Countries, Languages, NAICS sectors, HTTP status codes, Constitutional amendments, World Series, Nobel winners, Titanic and Chemical Elements. States and U.S. Presidents are also complete and free, as is any dataset of 25 records or fewer. Larger datasets provide a fixed sample: their 10 most recently added records, so the newest additions are always in it.
A complete download contains every record currently held in that dataset. Some records may still be missing or out of date, so check its description and sources for the years and records included.
When you need the whole list
One pass includes every dataset and collection.
Download complete datasets, whole categories and every collection, and make more API requests per day. Your key works across the catalog for 365 days.
One payment. No subscription or automatic renewal.
Data Pass $69for 365 days
Get the Data PassFree or paid, you can use the data in any project, including products and services you sell. Just don't pass on the datasets themselves; the terms explain what that means.
For applications and scripts
Make your first API request.
Start with States. It is free in full, so you can try the request without a key. Choose a format and open the result, or copy the URL into your own code.
The dataset name is the last part of its page address: /content/datasets/states becomes /api/data/states. This URL returns JSON unless you choose another format.
Collections work a little differently: /api/collections/{name} returns a ZIP of files in the format you choose, and People has its own route, /api/people. Each collection page shows how to download it.
API parameters and examples
| Parameter | What it does | Example |
|---|---|---|
format | Choose json, xml, or csv. | format=csv |
formatting | Use indented or none for JSON and XML. | formatting=none |
rows | Limit the number of returned records. | rows=5 |
sort | Sort by a field; add desc for descending order. | sort=President desc |
random | Shuffle the available records. | random=true |
pagesize, pagenumber | Split the available records into pages, starting at page 1. | pagesize=5&pagenumber=2 |
download | Return the result as an attachment. | download=true |
full | Require complete access; return an error instead of a sample when a paid key is needed. | full=true |
Use the original field names from an API response or downloaded file. Column headings in the preview include spaces to make them easier to read: Airport name may be AirportName in a request.
For example, request five Presidents in descending order. Without a pass, sorting, paging, and randomization stay within the available free records; they cannot retrieve records outside the free sample.
Using the older /api/data?list={dataset} route? It defaults to XML. Set format explicitly to choose another format.
Already have a pass?
Your key arrives by email after payment. Keep that email: the download form does not save your key. You can use the same key for file downloads, category ZIPs, and API requests.
In your application, send it in the Authorization header. For a dataset that needs a pass, add full=true to require the complete file. Without a valid key, the request returns an error instead of a sample.
curl -H "Authorization: Bearer YOUR_KEY" \
"https://mysafeinfo.com/api/data/countrycallingcodes?format=csv&full=true" \
-o country-calling-codes.csvKeep your key private. Store it on your server or in your local environment. Do not put it in a URL, a public repository, or browser code. Replace YOUR_KEY in the example with your own key.
Expiry date and where the key goes
Dataset responses from /api/data made with your key include an X-Key-Expires header with the date your pass ends (yyyy-MM-dd). Send the key only in the Authorization header; a key in the URL is not accepted.
Download a category in one ZIP.
Need several datasets on the same subject? Choose a category and a file format, then use your Data Pass key to download them together. The ZIP contains a separate file for each dataset and a README with dataset links and source references.
Open category downloadsDownload a category through the API
curl -H "Authorization: Bearer YOUR_KEY" \
"https://mysafeinfo.com/api/bundles/History?format=csv" \
-o history.zipUse a category name from the catalog and URL-encode spaces. Choose csv, json, or xml.
Each ZIP counts as one request toward your daily limit, and you can download up to 10 ZIPs a minute. A ZIP holds up to 64 MB of data, so download a larger category one dataset at a time.
Limits & troubleshooting
Every file download and API request counts toward a daily limit.
Free
50 a day, shared by everyone on the same internet connection
Data Pass
2,500 a day, for your key alone
Why do I only get 10 records?
Without a pass, most datasets give you a sample of their 10 most recently added records. To get every record, paste your pass key under Already have a pass? on the dataset page. In your own code, send the key in the Authorization header, as shown in Use your pass key.
My pass key isn’t working.
Copy the whole key from your purchase email, with no spaces before or after it, and check that your pass hasn’t ended. A pass lasts 365 days from purchase.
In code, a problem with the key returns an error status and a short message explaining it.
The API says a dataset wasn’t found.
Use the last part of the dataset’s page address. For /content/datasets/states, the name is states.
I reached a limit.
The daily limit resets within 24 hours. There are also per-minute limits: 30 requests a minute free, 60 with a pass, and 10 category or collection ZIPs a minute. If you hit one of those, wait a minute and try again.
In code, a limit returns HTTP 429 with a Retry-After header that says how many seconds to wait.
Still stuck? Get in touch with the dataset name and what happened. Please leave your pass key out of the message.