# Source: https://datacollective.mozillafoundation.org/api-reference

![](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld2JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiIGNsYXNzPSJsdWNpZGUgbHVjaWRlLW1lbnUgaC02IHctNiB0ZXh0LWJsYWNrIiBhcmlhLWhpZGRlbj0idHJ1ZSI+PHBhdGggZD0iTTQgMTJoMTYiIC8+PHBhdGggZD0iTTQgMThoMTYiIC8+PHBhdGggZD0iTTQgNmgxNiIgLz48L3N2Zz4=)

[![Mozilla Data Collective Logo](/_next/image?url=%2F_next%2Fstatic%2Fmedia%2FMDC-Logo-Black-Alpha.9b2f961c.png&w=256&q=75)](/)

[](/datasets)

Datasets

[](/api-reference)

API

[](https://community.mozilladatacollective.com/about)

About

![](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld2JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiIGNsYXNzPSJsdWNpZGUgbHVjaWRlLWxhbmd1YWdlcyBoLTUgdy01IiBhcmlhLWhpZGRlbj0idHJ1ZSI+PHBhdGggZD0ibTUgOCA2IDYiIC8+PHBhdGggZD0ibTQgMTQgNi02IDItMyIgLz48cGF0aCBkPSJNMiA1aDEyIiAvPjxwYXRoIGQ9Ik03IDJoMSIgLz48cGF0aCBkPSJtMjIgMjItNS0xMC01IDEwIiAvPjxwYXRoIGQ9Ik0xNCAxOGg2IiAvPjwvc3ZnPg==)[\...]![](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld2JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiIGNsYXNzPSJsdWNpZGUgbHVjaWRlLWNoZXZyb24tZG93biBoLTQgdy00IHRleHQtYmxhY2siIGFyaWEtaGlkZGVuPSJ0cnVlIj48cGF0aCBkPSJtNiA5IDYgNiA2LTYiIC8+PC9zdmc+)

## Harness community-driven datasets with our API 

![](/_next/static/media/explosion-brown.af87765e.svg)

[![](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld2JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiIGNsYXNzPSJsdWNpZGUgbHVjaWRlLWdpdC1icmFuY2ggaC00IHctNCIgYXJpYS1oaWRkZW49InRydWUiPjxsaW5lIHgxPSI2IiB4Mj0iNiIgeTE9IjMiIHkyPSIxNSI+PC9saW5lPjxjaXJjbGUgY3g9IjE4IiBjeT0iNiIgcj0iMyI+PC9jaXJjbGU+PGNpcmNsZSBjeD0iNiIgY3k9IjE4IiByPSIzIj48L2NpcmNsZT48cGF0aCBkPSJNMTggOWE5IDkgMCAwIDEtOSA5IiAvPjwvc3ZnPg==)]

**Version:** Beta

The Mozilla Data Collective API gives developers access to community-created datasets while empowering contributors to maintain control over their data.

![](/_next/static/media/api-key.2fa33ae8.svg)

Get API Access

Browse API Docs

![](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld2JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiIGNsYXNzPSJsdWNpZGUgbHVjaWRlLWV4dGVybmFsLWxpbmsgaC01IHctNSIgYXJpYS1oaWRkZW49InRydWUiPjxwYXRoIGQ9Ik0xNSAzaDZ2NiIgLz48cGF0aCBkPSJNMTAgMTQgMjEgMyIgLz48cGF0aCBkPSJNMTggMTN2NmEyIDIgMCAwIDEtMiAySDVhMiAyIDAgMCAxLTItMlY4YTIgMiAwIDAgMSAyLTJoNiIgLz48L3N2Zz4=)

### Mozilla Data Collective API at a glance 

![](/_next/static/media/bolt.6cc5dd83.svg)

###### Create access credentials 

Manage your API credentials by going to Profile \> API

![](/_next/static/media/shield.adf7b3f8.svg)

###### Secure your key 

Store your access credentials in a secret key

![](/_next/static/media/union.8c13a218.svg)

###### Authentication 

Provide your API key in your request header to authenticate

![](/_next/static/media/globe.c5f0f2b4.svg)

###### Select your dataset 

Choose from over 300 global datasets to use

![](/_next/static/media/check-box.bde4576f.svg)

###### Agree to dataset terms 

You will only be able to download datasets after accepting terms

![](/_next/static/media/arrow.8945111a.svg)

###### Download 

Use our REST endpoint or the MDC python library to get started

[](/profile/credentials)

Create API credentials

![](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld2JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiIGNsYXNzPSJsdWNpZGUgbHVjaWRlLWV4dGVybmFsLWxpbmsgaC00IHctNCIgYXJpYS1oaWRkZW49InRydWUiPjxwYXRoIGQ9Ik0xNSAzaDZ2NiIgLz48cGF0aCBkPSJNMTAgMTQgMjEgMyIgLz48cGF0aCBkPSJNMTggMTN2NmEyIDIgMCAwIDEtMiAySDVhMiAyIDAgMCAxLTItMlY4YTIgMiAwIDAgMSAyLTJoNiIgLz48L3N2Zz4=)

### API Overview 

Power your projects with diverse, ethically-created datasets that are just one REST call away.

![](/_next/static/media/api-key.2fa33ae8.svg)

Get API Access

Browse API Docs

![](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld2JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiIGNsYXNzPSJsdWNpZGUgbHVjaWRlLWV4dGVybmFsLWxpbmsgaC01IHctNSIgYXJpYS1oaWRkZW49InRydWUiPjxwYXRoIGQ9Ik0xNSAzaDZ2NiIgLz48cGF0aCBkPSJNMTAgMTQgMjEgMyIgLz48cGF0aCBkPSJNMTggMTN2NmEyIDIgMCAwIDEtMiAySDVhMiAyIDAgMCAxLTItMlY4YTIgMiAwIDAgMSAyLTJoNiIgLz48L3N2Zz4=)

![](/_next/image?url=%2F_next%2Fstatic%2Fmedia%2Fagave-plant.4188388a.png&w=1080&q=75)

copy![](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld2JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiIGNsYXNzPSJsdWNpZGUgbHVjaWRlLWNvcHkgaC00IHctNCIgYXJpYS1oaWRkZW49InRydWUiPjxyZWN0IHdpZHRoPSIxNCIgaGVpZ2h0PSIxNCIgeD0iOCIgeT0iOCIgcng9IjIiIHJ5PSIyIiAvPjxwYXRoIGQ9Ik00IDE2Yy0xLjEgMC0yLS45LTItMlY0YzAtMS4xLjktMiAyLTJoMTBjMS4xIDAgMiAuOSAyIDIiIC8+PC9zdmc+)

``` 
// Test code for connecting to Mozilla Data API

from datacollective import DataCollective
client = DataCollective()
client.get_dataset("mdc-dataset-id")
```

### Give it a try 

Get up and running with datacollective-python, a Python library for authenticating and interacting with the MDC API.

![](/_next/static/media/api-key.2fa33ae8.svg)[](https://pypi.org/project/datacollective/)

Python Library

Browse Docs

![](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld2JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiIGNsYXNzPSJsdWNpZGUgbHVjaWRlLWV4dGVybmFsLWxpbmsgaC01IHctNSIgYXJpYS1oaWRkZW49InRydWUiPjxwYXRoIGQ9Ik0xNSAzaDZ2NiIgLz48cGF0aCBkPSJNMTAgMTQgMjEgMyIgLz48cGF0aCBkPSJNMTggMTN2NmEyIDIgMCAwIDEtMiAySDVhMiAyIDAgMCAxLTItMlY4YTIgMiAwIDAgMSAyLTJoNiIgLz48L3N2Zz4=)

### Links & Docs 

[[]](/profile/credentials)

Get API Access

[[]](/api-reference/docs)

Browse API Docs

[[]](https://pypi.org/project/datacollective/)

Python Library

![](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld2JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiIGNsYXNzPSJsdWNpZGUgbHVjaWRlLWV4dGVybmFsLWxpbmsgaC01IHctNSB0cmFuc2l0aW9uLXRyYW5zZm9ybSBncm91cC1ob3Zlcjp0cmFuc2xhdGUteC0xIiBhcmlhLWhpZGRlbj0idHJ1ZSI+PHBhdGggZD0iTTE1IDNoNnY2IiAvPjxwYXRoIGQ9Ik0xMCAxNCAyMSAzIiAvPjxwYXRoIGQ9Ik0xOCAxM3Y2YTIgMiAwIDAgMS0yIDJINWEyIDIgMCAwIDEtMi0yVjhhMiAyIDAgMCAxIDItMmg2IiAvPjwvc3ZnPg==)[[]](https://github.com/Mozilla-Data-Collective/datacollective-python)

Python Library Source

![](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld2JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiIGNsYXNzPSJsdWNpZGUgbHVjaWRlLWV4dGVybmFsLWxpbmsgaC01IHctNSB0cmFuc2l0aW9uLXRyYW5zZm9ybSBncm91cC1ob3Zlcjp0cmFuc2xhdGUteC0xIiBhcmlhLWhpZGRlbj0idHJ1ZSI+PHBhdGggZD0iTTE1IDNoNnY2IiAvPjxwYXRoIGQ9Ik0xMCAxNCAyMSAzIiAvPjxwYXRoIGQ9Ik0xOCAxM3Y2YTIgMiAwIDAgMS0yIDJINWEyIDIgMCAwIDEtMi0yVjhhMiAyIDAgMCAxIDItMmg2IiAvPjwvc3ZnPg==)

![Mozilla Foundation Logo](/_next/image?url=%2F_next%2Fstatic%2Fmedia%2FMDC-Logo-White-Alpha.d9795f4c.png&w=640&q=75)

[](/privacy)

Privacy Policy![](/_next/static/media/external-link-white.9b62bd0f.svg)

[](/terms)

Terms![](/_next/static/media/external-link-white.9b62bd0f.svg)

[](https://www.mozilla.org/en-US/privacy/websites/#cookies)

Cookies![](/_next/static/media/external-link-white.9b62bd0f.svg)

[](https://community.mozilladatacollective.com/tag/faq/)

FAQs![](/_next/static/media/external-link-white.9b62bd0f.svg)

[](https://www.mozilla.org/en-US/about/governance/policies/participation/)

Participation Guidelines![](/_next/static/media/external-link-white.9b62bd0f.svg)

[![Email Icon](/_next/static/media/email-white.0e7c561e.svg)](mailto:mozilladatacollective@mozillafoundation.org)

mozilladatacollective@mozillafoundation.org

![](/_next/static/media/line-logo-white.249d380d.svg)

[](/privacy)

Privacy Policy![](/_next/static/media/external-link-white.9b62bd0f.svg)

[](/terms/consumers)

Terms![](/_next/static/media/external-link-white.9b62bd0f.svg)

[](/cookies)

Cookies![](/_next/static/media/external-link-white.9b62bd0f.svg)

[](/faqs)

FAQs![](/_next/static/media/external-link-white.9b62bd0f.svg)

![](/_next/static/media/line-logo-white.249d380d.svg)

[![Email Icon](/_next/static/media/email-white.0e7c561e.svg)](mailto:mozilladatacollective@mozillafoundation.org)

mozilladatacollective@mozillafoundation.org

![](/_next/static/media/line-logo-white.249d380d.svg)

![](/_next/static/media/mozilla-foundation-logo-white.49d832bb.svg)

Brought to you by [Mozilla Foundation](https://www.mozillafoundation.org)