Environment

Data source: Climate TRACE (climatetrace.org)

REST Bridge Endpoint https://context.gnist.ai/rest/climate-trace/

Authentication

All requests require a Gnist-API-Key header (or api_key query parameter).

Free tier: 100 calls/day. Get your API key.

Tools (7)

rank_countries_by_emissions
search_emission_sources
get_emission_source
get_aggregate_emissions
list_emission_sectors
list_emission_countries
report_feedback

rank_countries_by_emissions

Rank countries by greenhouse gas emissions.

Uses Climate TRACE data covering 252 countries and 60+ greenhouse gases.
Returns country rankings with total emissions and optional sector breakdowns.

Args:
gas: Gas type to rank by (default co2e_100yr).
start: Start year filter.
end: End year filter.
sectors: Comma-separated sector filter.
continent: Continent filter.

Returns:
Ranked list of countries with emissions totals.

Parameter	Type	Required	Description
`gas`	`string`	optional	Gas type: 'co2', 'co2e_20yr', 'co2e_100yr', 'ch4', 'n2o'. Default 'co2e_100yr'. (default: "co2e_100yr")
`start`	`any`	optional	Start year (inclusive). Omit for all available years.
`end`	`any`	optional	End year (inclusive). Omit for all available years.
`sectors`	`any`	optional	Comma-separated sectors (e.g. 'power,transportation'). Omit for all sectors.
`continent`	`any`	optional	Continent filter: 'Africa', 'Asia', 'Europe', 'North America', 'Oceania', 'South America'.

Request Body

{
  "query": "example"
}

search_emission_sources

Search for top emission sources (facilities, power plants, etc.).

Returns ranked emission sources with location, sector, and emissions data.
Sources include power plants, factories, oil/gas facilities, and more.

Args:
year: Filter by emissions year.
gas: Gas type (default co2e_100yr).
sectors: Comma-separated sector filter.
country: ISO country code filter.
limit: Max results (1-100, default 20).

Returns:
List of emission sources with name, location, sector, and emissions.

Parameter	Type	Required	Description
`year`	`any`	optional	Emissions year (e.g. 2022). Omit for latest.
`gas`	`string`	optional	Gas type (default 'co2e_100yr'). (default: "co2e_100yr")
`sectors`	`any`	optional	Comma-separated sectors (e.g. 'power,manufacturing').
`country`	`any`	optional	ISO country code (e.g. 'US', 'CHN', 'NOR').
`limit`	`integer`	optional	Number of results (1-100, default 20). (default: 20)

Request Body

{
  "query": "example"
}

get_emission_source

Get detailed information for a specific emission source.

Returns full details including time series emissions data for a single
facility or source identified by its Climate TRACE source ID.

Args:
source_id: Climate TRACE source ID.

Returns:
Source details with name, location, sector, and emissions time series.

Parameter	Type	Required	Description
`source_id`	`string`	required	Climate TRACE source ID. Use search_emission_sources to find IDs.

Request Body

{
  "source_id": "example"
}

get_aggregate_emissions

Get aggregate greenhouse gas emissions data.

Returns total emissions aggregated by the specified filters — useful for
comparing sectors, countries, or tracking emissions over time.

Args:
year: Filter by emissions year.
gas: Gas type (default co2e_100yr).
sectors: Comma-separated sector filter.
country: ISO country code filter.

Returns:
Aggregated emissions data for the specified filters.

Parameter	Type	Required	Description
`year`	`any`	optional	Emissions year (e.g. 2022). Omit for latest.
`gas`	`string`	optional	Gas type (default 'co2e_100yr'). (default: "co2e_100yr")
`sectors`	`any`	optional	Comma-separated sectors (e.g. 'power,transportation').
`country`	`any`	optional	ISO country code (e.g. 'US', 'CHN', 'DEU').

Request Body

{
  "query": "example"
}

list_emission_sectors

List all available emission sectors in Climate TRACE.

Returns the complete list of sectors used to categorize emission sources,
such as power, transportation, manufacturing, agriculture, etc.

Returns:
List of all sector definitions.

Request Body

{
  "query": "example"
}

list_emission_countries

List all countries tracked by Climate TRACE.

Returns the full list of 252 countries with emissions data available.

Returns:
List of all country definitions.

Request Body

{
  "query": "example"
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/climate-trace/get_emission_source" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"source_id": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/climate-trace/get_emission_source",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "source_id": "example"
},
)
print(resp.json())