We currently host a free, unauthenticated JSON REST API with the source dataset at the following location:

https://climate-action-rz2httdmhq-uc.a.run.app/api

This API is intended to help others perform their own analysis on this data.

API Endpoints

GET /v1/facilities

Example: Get all facilities

curl 'https://climate-action-rz2httdmhq-uc.a.run.app/api/v1/facilities' | jq

Example: Only facilities in a certain state (valid: IL, IN, IA, MI, OH, WI)

Query: ?state=IL

curl 'https://climate-action-rz2httdmhq-uc.a.run.app/api/v1/facilities?state=IL' | jq

Example: Only facilities not containing certain terms

Query: ?ignore_keywords=energy,landfill,power,generation,generating,cogeneration

curl 'https://climate-action-rz2httdmhq-uc.a.run.app/api/v1/facilities?ignore_keywords=energy,landfill,power,generation,generating,cogeneration' | jq

Example: Only facilities with total GHG greater than 25000 (metric tons CO2e)

Query: ?ghg_threshold=25000

curl 'https://climate-action-rz2httdmhq-uc.a.run.app/api/v1/facilities?ghg_threshold=25000' | jq

Example: Only facilities within 200 miles of Chicago city center (coordinates: 41.881832, -87.623177)

Query: ?distance_threshold=200

curl 'https://climate-action-rz2httdmhq-uc.a.run.app/api/v1/facilities?distance_threshold=200' | jq

Example: Specific facility by GHGRP Id

Query: ?ghcgrp_id=1000261

curl 'https://climate-action-rz2httdmhq-uc.a.run.app/api/v1/facilities?ghcgrp_id=1000261' | jq

Example: Only faciltiies matching multi-criteria:

Query: ?state=IL&ignore_keywords=energy,landfill,power,generation,generating,cogeneration&ghg_threshold=25000&distance_threshold=200

curl 'https://climate-action-rz2httdmhq-uc.a.run.app/api/v1/facilities?state=IL&ignore_keywords=energy,landfill,power,generation,generating,cogeneration&ghg_threshold=25000&distance_threshold=200' | jq