How to use the data
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.
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
These are project ideas you can try yourself. The starter files are free in full, with no account or pass key needed. Free request limits apply.
Students & new developers JSON
Fetch the States JSON, display the records, and add a search box for names or abbreviations. Show when records are loading, when a search finds nothing, and when a request fails.
You’ll have: a small project that shows how you work with real API data.
Developers & internal tools API
Request the States dataset and use its names and abbreviations for a dropdown in an internal form. Save a local copy so the application does not need to call the API every time the form opens.
You’ll have: a reusable dropdown without typing each state by hand.
Teachers & homeschool families CSV
Open Chemical Elements in Excel or Google Sheets. Look at the discovery fields, set aside entries without a numeric year, then group dated discoveries by century and make a chart. Discuss why some records may have no discovery date and what you would need to find out before explaining the gap.
You’ll have: a lesson that combines science, history, and spreadsheet skills.
Developers & data projects XML / ZIP
Download States as XML and map the records into your own application or database. Check the actual field names and structure in the file before writing your import.
When you need more: either paid pass includes category ZIPs in CSV, JSON, or XML, with a separate file for each dataset and a README containing source references.
These examples help you try the formats. For your own project, check which records it includes and where they came from; for a product or service provided to others, see the Commercial Pass.
For spreadsheets and everyday work
Browse the catalog or search for a subject. Check the preview, description, and sources to see whether the dataset covers what you need.
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.
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.
For Excel, Google Sheets, and other spreadsheet tools.
For applications, scripts, and web projects.
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.
States, U.S. Presidents, and Chemical Elements are free in full. Other datasets provide a fixed sample of up to 10 records. If a whole dataset fits within that limit, you get all of it.
A complete download contains every record currently held in that dataset. Check its description and sources for the years and records included; complete access does not guarantee that nothing is missing or out of date.
When you need the whole list
Download complete datasets or whole categories, 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 $39for 365 days
Choose your passFree access and the Data Pass cover your own projects, teaching, research, and internal business work. For data used in a product or service you sell or provide to others, choose a Commercial Pass.
For applications and scripts
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.
| 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.
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. Add full=true when you need the complete dataset, so a missing key produces an error instead of a sample.
curl -H "Authorization: Bearer YOUR_KEY" \
"https://mysafeinfo.com/api/data/nobelwinners?format=csv&full=true" \
-o nobelwinners.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.
Successful keyed responses include X-Key-Expires, with the expiry date in yyyy-MM-dd format. An old Developer pass key still works with the renamed Data Pass.
Paid keys are not accepted in the query string. Legacy private WICK integrations use their existing access rules.
Need several datasets on the same subject? Choose a category and a file format, then use either paid pass to download them together. The ZIP contains a separate file for each dataset and a README with dataset links and source references.
Open category downloadscurl -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 API request. Each pass key allows up to 10 category downloads per minute, with up to 64 MB of uncompressed data per ZIP. Download larger categories one dataset at a time.
File downloads and API calls use the same request allowance. Free limits are shared by requests from the same IP address. Paid limits apply to each key.
| Access | Per minute | Per day |
|---|---|---|
| Free downloads & API requests from a browser | 30 | 50 |
| Recognized automated clients without a pass | 6 | 200 |
| Data Pass | 60 | 2,500 |
| Commercial Pass | 120 | 25,000 |
Most datasets return a fixed sample without a paid key. For the complete file, use the pass-key form on the dataset page. For the API, send your key in the Authorization header. Add full=true to get an error instead of a sample if a paid key is needed and was not supplied.
Copy the full key from your purchase email and check that your pass has not expired. A complete paid download or category ZIP without a qualifying key returns HTTP 403. An invalid or expired key returns an error explaining the problem.
Data-request errors include a JSON message, for example:
{"message":"The requested list was not found."}Check that the dataset name matches the last part of its catalog page address.
Wait before retrying. When present, the Retry-After header gives the number of seconds to wait. Category ZIPs also have their own per-minute limit, even when your pass has API requests remaining.
Still stuck? Get in touch with the dataset name and error message. Please leave your pass key out of the message.