{"uid":"cap_EBojvjbZHi_2w79NIWTrx","slug":"iea-energy-statistics-api-via-sitecheck-trade-energy-f3ee1588","name":"IEA Energy Statistics API via SiteCheck Trade & Energy","description":"IEA (International Energy Agency) energy statistics for one country and one indicator (default CO2BySource: CO2 emissions by fuel and product, MtCO2), from the public IEA stats API. Returns the latest year(s) in the source. Indicator list is the IEA catalogue; not every indicator has data for every country.","url":"https://api.tradeenergy-api.workers.dev/api/energy/iea-energy-statistics-api?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"years":{"type":"string","description":"How many latest years to return, 1 to 5 (default 1)"},"country":{"type":"string","description":"IEA country code (3 letters), e.g. USA"},"indicator":{"type":"string","description":"IEA indicator id, e.g. CO2BySource (default)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"years":[2024],"source":"https://api.iea.org/stats/indicators/CO2BySource?countries=USA","country":"USA","records":[{"flow":"Total CO2 emissions - Fuel Combustion","year":2024,"units":"MtCO2","value":739.925,"product":"Coal"},{"flow":"Total CO2 emissions - Fuel Combustion","year":2024,"units":"MtCO2","value":1867.434,"product":"Oil"}],"checkedAt":"2026-10-23T09:38:24.798Z","indicator":"CO2BySource","latestYear":2024}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wHXw2adLlp4Ebv9fMrwO6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches IEA energy statistics (e.g. CO2 emissions by fuel) for a specified country and indicator, returning the latest year(s) of data.","exampleAgentPrompt":"Pull the IEA CO2 emissions by source data for Germany for the last 3 years — I need the breakdown by fuel and product in MtCO2.","exampleUseCases":[{"title":"National CO2 emissions trend analysis","prompt":"Get me the IEA CO2 emissions by source for the USA for the past 5 years so I can see how emissions have changed over time."},{"title":"Country energy indicator comparison","prompt":"Look up the IEA energy statistics for France using the CO2BySource indicator — just the most recent year."},{"title":"Custom IEA indicator for policy research","prompt":"Fetch IEA energy data for India using the indicator TotElecProd for the last 2 years — I need the latest production figures."}],"resultDescription":"Returns a JSON object containing the queried country code, indicator ID, list of years returned, the source IEA API URL, a checkedAt timestamp, the latest available year, and an array of records each with flow, year, units, value, and product fields.","failureModes":["Country code not recognized by IEA — returns error or empty records","Indicator ID not available for the requested country — empty records array","years parameter out of range (outside 1-5) — may return error or default","IEA upstream API unavailable — proxy returns error","Invalid or missing required query parameters"],"whenToPreferThis":"Use this endpoint when you need official IEA energy statistics (especially CO2 emissions by fuel/product) for a specific country, and want the latest available year(s) without building your own IEA API integration. Prefer this over raw IEA API calls when working within a pay-per-call agent framework. Not suitable for bulk multi-country queries or non-IEA data sources.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:33:49.174Z","isFirstParty":false,"canonicalSlug":"iea-energy-statistics-api-via-sitecheck-trade-energy-f3ee1588"}