Open endpoints

The data behind the dashboards, as JSON.

Every series and register the dashboards read is served from this domain. No key is needed; responses are cached at the edge for an hour and carry the publisher, unit and period range. Member exports stay behind membership.

Endpoint	Returns
`GET /api/status`	Every mirrored series and register with its publisher, period range, point count, last sync and status. A single place to see whether the data is fresh.
`GET /api/data/portal/{series}`	One series: its metadata and every point (period, region, category, value, unit). Series ids are listed below.
`GET /api/data/oil-model?scenario=base\|tight\|transition\|flood&horizon=36`	The oil balance model on the live inputs: levers, monthly path (anchor, price, band, demand, supply, stock change, inventories), summary and source status. Any lever can be set by query.
`GET /api/data/registers/{sppc\|swpc\|swa}`	An official register as last mirrored: the source row and every project or dataset the publisher lists.
`GET /api/cards/{card}?locale=en\|ar`	A 1200 by 630 PNG share card with live figures. Cards: oil, saudi-renewables, global-ccus, saudi-data-centres, energy-transition.
`GET /api/search?q=…`	Ranked matches across pages, dashboards, datasets, series, insights and projects, the same index the command palette uses.

Example

curl https://renewablevision.com.sa/api/data/portal/eia-oil-spot

Series ids

Pass any of these to the portal endpoint. Owner-uploaded series appear once data has been added.

id	Series	Publisher	Unit
`eia-world-balance`	World oil supply, demand and stock change (EIA outlook)	U.S. Energy Information Administration, Short-Term Energy Outlook, via KAPSARC	mb/d
`eia-us-crude-stocks`	US commercial crude stocks, weekly	U.S. Energy Information Administration, via KAPSARC	million barrels
`eia-us-crude-production`	US crude oil production, monthly	U.S. Energy Information Administration, via KAPSARC	mb/d
`eia-gas-spot`	Henry Hub natural gas spot price, daily	U.S. Energy Information Administration, via KAPSARC	US$/MMBtu
`iea-ev-sales-share`	Electric-car share of new car sales, by region	International Energy Agency, Global EV Outlook, via KAPSARC	%
`sama-world-oil-production`	World oil production by producer group, annual	Saudi Central Bank (SAMA) yearly statistics, via KAPSARC	mb/d
`irena-capacity-world`	World installed electricity capacity by technology	International Renewable Energy Agency (IRENASTAT)	MW
`iea-ev-world`	Electric vehicles worldwide: sales, share, stock and oil displaced (IEA)	International Energy Agency, Global EV Data Explorer	mixed