In this example I will demonstrate how to request json data from the Ecoengine.
import requests
The requests library makes interacting with an API quite easy.
headers = {'Accept': 'application/json'}
r = requests.get('https://ecoengine.berkeley.edu/api/observations/', headers=headers)
r.status_code
200
Status code 200 means that the API returned valid data.
if r.status_code == 200:
print r.json()
{u'count': 4674293, u'previous': None, u'results': [{u'state_province': u'California', u'begin_date': u'2007-01-01T00:00:00', u'end_date': u'2007-12-31T00:00:00', u'source': u'https://ecoengine.berkeley.edu/api/sources/18/', u'url': u'https://ecoengine.berkeley.edu/api/observations/bigcb%3Aspecieslist%3A6%3A1362/', u'country': u'USA', u'geojson': None, u'scientific_name': u'Milnesium tardigradum', u'remote_resource': u'http://bigcb.berkeley.edu/cgi/bigcb_speclist_show?ItemID=1362', u'observation_type': u'checklist'}, {u'state_province': u'California', u'begin_date': u'2007-01-01T00:00:00', u'end_date': u'2007-12-31T00:00:00', u'source': u'https://ecoengine.berkeley.edu/api/sources/18/', u'url': u'https://ecoengine.berkeley.edu/api/observations/bigcb%3Aspecieslist%3A6%3A1360/', u'country': u'USA', u'geojson': None, u'scientific_name': u'Milnesium tardigradum', u'remote_resource': u'http://bigcb.berkeley.edu/cgi/bigcb_speclist_show?ItemID=1360', u'observation_type': u'checklist'}, {u'state_province': u'California', u'begin_date': u'2007-01-01T00:00:00', u'end_date': u'2007-12-31T00:00:00', u'source': u'https://ecoengine.berkeley.edu/api/sources/18/', u'url': u'https://ecoengine.berkeley.edu/api/observations/bigcb%3Aspecieslist%3A6%3A1361/', u'country': u'USA', u'geojson': None, u'scientific_name': u'Milnesium tardigradum', u'remote_resource': u'http://bigcb.berkeley.edu/cgi/bigcb_speclist_show?ItemID=1361', u'observation_type': u'checklist'}, {u'state_province': u'California', u'begin_date': u'2007-01-01T00:00:00', u'end_date': u'2007-12-31T00:00:00', u'source': u'https://ecoengine.berkeley.edu/api/sources/18/', u'url': u'https://ecoengine.berkeley.edu/api/observations/bigcb%3Aspecieslist%3A6%3A1359/', u'country': u'USA', u'geojson': None, u'scientific_name': u'Milnesium tardigradum', u'remote_resource': u'http://bigcb.berkeley.edu/cgi/bigcb_speclist_show?ItemID=1359', u'observation_type': u'checklist'}, {u'state_province': u'California', u'begin_date': u'2007-01-01T00:00:00', u'end_date': u'2007-12-31T00:00:00', u'source': u'https://ecoengine.berkeley.edu/api/sources/18/', u'url': u'https://ecoengine.berkeley.edu/api/observations/bigcb%3Aspecieslist%3A6%3A1358/', u'country': u'USA', u'geojson': None, u'scientific_name': u'Milnesium tardigradum', u'remote_resource': u'http://bigcb.berkeley.edu/cgi/bigcb_speclist_show?ItemID=1358', u'observation_type': u'checklist'}, {u'state_province': u'California', u'begin_date': u'2007-01-01T00:00:00', u'end_date': u'2007-12-31T00:00:00', u'source': u'https://ecoengine.berkeley.edu/api/sources/18/', u'url': u'https://ecoengine.berkeley.edu/api/observations/bigcb%3Aspecieslist%3A6%3A1357/', u'country': u'USA', u'geojson': None, u'scientific_name': u'Milnesium tardigradum', u'remote_resource': u'http://bigcb.berkeley.edu/cgi/bigcb_speclist_show?ItemID=1357', u'observation_type': u'checklist'}, {u'state_province': u'California', u'begin_date': u'2007-01-01T00:00:00', u'end_date': u'2007-12-31T00:00:00', u'source': u'https://ecoengine.berkeley.edu/api/sources/18/', u'url': u'https://ecoengine.berkeley.edu/api/observations/bigcb%3Aspecieslist%3A6%3A1356/', u'country': u'USA', u'geojson': None, u'scientific_name': u'Milnesium tardigradum', u'remote_resource': u'http://bigcb.berkeley.edu/cgi/bigcb_speclist_show?ItemID=1356', u'observation_type': u'checklist'}, {u'state_province': u'California', u'begin_date': u'2007-01-01T00:00:00', u'end_date': u'2007-12-31T00:00:00', u'source': u'https://ecoengine.berkeley.edu/api/sources/18/', u'url': u'https://ecoengine.berkeley.edu/api/observations/bigcb%3Aspecieslist%3A6%3A1355/', u'country': u'USA', u'geojson': None, u'scientific_name': u'Milnesium tardigradum', u'remote_resource': u'http://bigcb.berkeley.edu/cgi/bigcb_speclist_show?ItemID=1355', u'observation_type': u'checklist'}, {u'state_province': u'California', u'begin_date': u'2007-01-01T00:00:00', u'end_date': u'2007-12-31T00:00:00', u'source': u'https://ecoengine.berkeley.edu/api/sources/18/', u'url': u'https://ecoengine.berkeley.edu/api/observations/bigcb%3Aspecieslist%3A6%3A1354/', u'country': u'USA', u'geojson': None, u'scientific_name': u'Milnesium tardigradum', u'remote_resource': u'http://bigcb.berkeley.edu/cgi/bigcb_speclist_show?ItemID=1354', u'observation_type': u'checklist'}, {u'state_province': u'California', u'begin_date': u'2007-01-01T00:00:00', u'end_date': u'2007-12-31T00:00:00', u'source': u'https://ecoengine.berkeley.edu/api/sources/18/', u'url': u'https://ecoengine.berkeley.edu/api/observations/bigcb%3Aspecieslist%3A6%3A1353/', u'country': u'USA', u'geojson': None, u'scientific_name': u'Milnesium tardigradum', u'remote_resource': u'http://bigcb.berkeley.edu/cgi/bigcb_speclist_show?ItemID=1353', u'observation_type': u'checklist'}], u'next': u'https://ecoengine.berkeley.edu/api/observations/?page=2'}