Renewable Nodes API — Documentation

Overview

The Renewable Nodes API provides structured data on renewable energy share, capacity, targets, and energy mix breakdown for 93+ countries and territories worldwide. Data compiled from Ember, IRENA, IEA, and national energy agencies. Updated daily.

Endpoints

GET /wp-content/uploads/api-data.json

Returns all country data including renewable percentages, energy mix, targets, and trend data.

GET /embed?source={source}®ion={region}&count={n}

Response Format

{
  "updated": "2026-02-28T15:00:00Z",
  "stats": { "countryCount": 93, "globalAvg": 38.2 },
  "trendYears": [2019, 2020, ... , 2025],
  "countries": [
    {
      "id": "IS",
      "name": "Iceland",
      "region": "Europe",
      "renewable": 100,
      "solar": 0, "wind": 0, "hydro": 70, "geo": 30, "bio": 0,
      "capacity": 2.9,
      "target": 0, "targetYear": 0,
      "trend": [100, 100, 100, ...],
      "pop": 0.4, "dataYear": 2025
    }
  ]
}

Data Fields

Field	Type	Description
`id`	String	ISO 3166-1 alpha-2 country code
`name`	String	Country name
`region`	String	Continent: Europe, Americas, Asia, Africa, Oceania
`renewable`	Number	Total renewable electricity share (%)
`solar`	Number	Solar share of electricity (%)
`wind`	Number	Wind share of electricity (%)
`hydro`	Number	Hydropower share of electricity (%)
`geo`	Number	Geothermal share of electricity (%)
`bio`	Number	Biomass/other renewable share (%)
`capacity`	Number	Installed renewable capacity (GW)
`target`	Number	National renewable target (%), 0 if none
`targetYear`	Number	Target year, 0 if none
`trend`	Array	Historical renewable % (aligned with trendYears)
`pop`	Number	Population in millions
`dataYear`	Number	Most recent data year

Embed Widgets

Add live renewable energy widgets to your website. Two widgets are available:

RANKINGS /embed?source={source}®ion={region}&count={n}

Top countries ranked by renewable share. Filterable by source and region.

COUNTRY CARD /country-card?country={code}&theme={light|dark}

Individual country profile card with energy mix, capacity, and target progress. Use ISO 2-letter codes (e.g., PT, FR, US).

Both widgets support ?theme=dark parameter and auto-detect system preferences.

<iframe src="https://renewablenodes.com/embed"
width="400" height="500" frameborder="0"></iframe>


<iframe src="https://renewablenodes.com/embed?source=wind&region=Europe&count=5"
width="400" height="350" frameborder="0"></iframe>

Clean Country URLs

Each country has a shareable, SEO-friendly URL:

// Examples:
https://renewablenodes.com/portugal
https://renewablenodes.com/united-states
https://renewablenodes.com/south-korea

These URLs serve Open Graph meta tags for rich social media previews on LinkedIn, Twitter, and WhatsApp.

Pricing

Choose the plan that fits your needs.

Embed

Free

Embeddable widget for your site
Top 10 ranking display
Filter by source and region
Attribution required

Get Embed Code

Pro

Custom

Full JSON API access
CSV and PDF exports
Quarterly analysis reports
Custom data queries
Co-branded reports
Priority support

Contact Us

Enterprise

Custom

Everything in Pro
White-label widgets
Historical data archive
Custom API endpoints
SLA guarantee

Contact Us