The data behind the dashboards, for your own code.

Freshness of every mirrored series and register

Every series and register with its publisher, period range, point count, last sync and status; every source the platform refreshes with its cadence, last successful refresh and state; and a self-check of every public endpoint, with the stored daily history where it exists. ok is false only when a source has aged past its refresh cadence. The page at /status renders the same computation.

One mirrored series: metadata and every point

An official register, as last mirrored or as it stood on a past day

One project from the Saudi Renewables Tracker, as its page shows it

Capacity, technology, the stage this site counts with the Principal Buyer register beside it, developers with their published shares, the published tariff, modelled generation marked as modelled, and the project’s change-ledger entries. A project in the tracker’s captive and corporate segment answers at the same address with its own record: capacity as its source states it, owners, developer and offtaker, the contract type, every source with the date it was read, and the readings where sources disagree. Location is locality and region only; plant coordinates are not published.

One developer or shareholder and every tracked project that names it

Published equity shares, capacity by stage and technology, capacity attributable by published equity share, and recent ledger changes across its projects.

The GCC Renewables Tracker: utility-scale projects in five GCC states

Solar PV, concentrated solar, wind and battery projects of 50 MW or more in the UAE, Oman, Qatar, Kuwait and Bahrain, compiled from the procurers and developers. Each row carries its sources with the date they were read, the stage in the source’s own words, and the readings where sources disagree. Capacity is as each source states it (MWac, MWp or MW); a tariff appears only where one was published. Location is locality and region only.

One project from the GCC Renewables Tracker, as its page shows it

Capacity as the source states it, owners with the shares they publish, procurer and offtaker, the stage in the source’s own words, the published tariff where there is one, every source with the date it was read, and the readings where sources disagree. Plant coordinates are not published.

The change ledger: every row-level change, newest first

Magnitudes carry their own unit and are not comparable across units, so ranking across them is left to the caller.

What is expected to refresh next, and what is late

Refresh dates are this site’s own cadence, not a commitment by the publisher; commercial operation years are carried as the publisher states them.

Operational capacity against the contracted pipeline and the 2030 target

The oil balance model run on the live inputs

Modelled, not observed. Any lever can be set by query: demandGrowth, evShareEnd, powerDisplacement, petrochemicals, gasSwitching, opecPolicy, shaleElasticity, demandElasticity, inventorySensitivity. An unknown scenario falls back to base.

The week ahead for the tracked Saudi solar fleet

Expected generation against the long-run normal, day by day, and the peak temperature forecast at the three main load centres. Aggregated across the fleet; no plant location is returned.

The solar and wind resource for one 0.5° cell of the NASA POWER grid

Long-run means (NASA POWER climatology, 2001–2020) of global horizontal and direct normal irradiance, wind speed at 50 m, air temperature and aerosol optical depth at 550 nm (the dust that soils panels), annual and by month, for the 0.5° cell a place falls in. Ask with exactly one of point, cell or project. An area-level answer: a point is snapped to its cell and is not echoed back, and a project is looked up at its locality, never its site.

The whole NASA POWER resource grid behind the Energy Atlas (members)

Five parameters (global horizontal and direct normal irradiance, wind at 50 m, air temperature, aerosol optical depth), the annual mean and every month, on 0.5° nodes from 12°N to 33°N and 34°E to 60°E. Each layer is quantised and delta-encoded along each row; note says how to decode it. Changes only when the grid is rebuilt from NASA POWER. Members only: send a member’s API key (keys are issued to free members at /account/api), or call it from this site while signed in. Without either the answer is 401 membersOnly, with the reason in English and Arabic and a link to join; when a key cannot be checked the answer is 503 keyUnverified, never an anonymous one.

Country series for the six GCC states: capacity, generation, demand, emissions (members)

IRENA installed solar, wind and renewable capacity; Our World in Data solar and wind generation, shares of electricity, demand and the carbon intensity of electricity; World Bank CO2 per person, population and renewable share of final energy. By country and year, each metric with its own publisher, licence and unit. Mirrored weekly, with a committed snapshot behind it. Members only: send a member’s API key (keys are issued to free members at /account/api), or call it from this site while signed in. Without either the answer is 401 membersOnly, with the reason in English and Arabic and a link to join; when a key cannot be checked the answer is 503 keyUnverified, never an anonymous one.

Headlines on GCC energy, from publishers’ feeds and GDELT

Gathered every three hours from publishers’ own RSS and Atom feeds and, best effort, the GDELT Project’s DOC 2.0 API; only headlines about GCC energy (renewables, storage, hydrogen, power, oil and gas, water, data-centre power) are kept. Each item is a headline, its link, the publisher’s domain, the date and its language; no summary or article text is stored. Items carry the tracker projects and companies the headline names unambiguously. Empty until the news table exists.

The Energy Atlas project layer, placed at locality level (members)

Every tracked Saudi, GCC and captive project with stage, capacity as stated, commercial operation year (actual or expected), published tariff and developers, each placed at a public town centroid rounded to 0.1° or at its region or country (place.precision). undated holds the rows with no stated operation year. storage holds every Saudi battery storage project that the Renewable Vision reports RV-SAU-SERIES03-20260912 and RV-SAU-RENEWABLES-GUIDE-20260912 name with a figure, each with its MWh (never added to MW), the report id and page it is read from, the sources the report cites, and any figure another source gives differently (the report’s figure is kept). tariff.usCents is the published tariff in US cents/kWh: for Saudi tracker rows, the levelised cost of electricity as tendered that KAPSARC publishes; for GCC rows, the tariff the procurer or developer published. Data-centre records are placed at city level. Plant sites are not published. Members only: send a member’s API key (keys are issued to free members at /account/api), or call it from this site while signed in. Without either the answer is 401 membersOnly, with the reason in English and Arabic and a link to join; when a key cannot be checked the answer is 503 keyUnverified, never an anonymous one.

Every project from every tracker, filtered by any facet (members)

The project index: the Saudi Renewables Tracker, its captive and corporate segment, the GCC Renewables Tracker, Saudi battery storage, Saudi data centres, the global CCUS tracker and the IEA hydrogen production projects database, each row described on the same facets (place, sector, technology, stage, commitment, milestones, investment, capacity, actors with roles, programme, source and verification). The same query language as the page /data/projects: several values of one parameter are alternatives, parameters combine; a place matches everything inside it (place=gcc, place=saudi-arabia/red-sea); ordered facets take ranges (stage=construction..); dates take ranges at any precision (cod=2027..2028). A field the source does not publish is null, never estimated, and notDisclosed counts them. A capacity range is read in one unit family only (the unit named, else the first sector named, else MW, MWp and MWac as stated), and capacity says which and how many rows it left out. format=csv and format=geojson answer the same rows as a file; GeoJSON points are public town or region centroids, or the source’s own point, never finer than 0.1°. Members only: send a member’s API key (keys are issued to free members at /account/api), or call it from this site while signed in. Without either the answer is 401 membersOnly, with the reason in English and Arabic and a link to join; when a key cannot be checked the answer is 503 keyUnverified, never an anonymous one.

The largest Saudi solar, wind and hybrid projects as an Excel workbook (members)

The lists on /data/renewables/saudi-arabia/largest as an .xlsx: one sheet per kind (solar, wind, hybrid), largest first, with the capacity in MW, technology, stage, operation year (target or actual), region, developers and each project’s page, and a sheet with the source, the as-of date and the licence line. One of a member’s monthly downloads; unlimited with RV Plus. Members only: send a member’s API key (keys are issued to free members at /account/api), or call it from this site while signed in. Without either the answer is 401 membersOnly, with the reason in English and Arabic and a link to join; when a key cannot be checked the answer is 503 keyUnverified, never an anonymous one.

The tenders board as an Excel workbook (members)

The energy and water tenders on /tenders as an .xlsx, newest first: what is tendered, the buyer, the market, the sector, the stage, the contract model, the size, the bid deadline when announced, the announcement date and who it suits; and a sheet with the as-of date and the licence line. Facts only, never the headline or its publisher. One of a member’s monthly downloads; unlimited with RV Plus. Members only: send a member’s API key (keys are issued to free members at /account/api), or call it from this site while signed in. Without either the answer is 401 membersOnly, with the reason in English and Arabic and a link to join; when a key cannot be checked the answer is 503 keyUnverified, never an anonymous one.

Every upstream source the site reads, with its licence and health

Publisher, what is taken, the licence and how far it lets rows travel, refresh cadence, the last successful pull, rows held, the pull history where it exists, and a state: live, awaiting key, awaiting access, failed or pending. The page at /developers/integrations renders the same list.

One integrated source’s rows, filtered, with its upstream licence

Filters depend on the source (country, year, sector, indicator, product, partner, topic, city, company); an unknown filter or a value the rows do not hold is refused with the list of what exists. CSV where the licence allows; UN Comtrade and PeeringDB answer 403 csvNotLicensed. A keyed source without its key answers with its state and no rows. PVGIS answers with the project estimates, never the yield cells, and, like /api/data/project-output, answers members only: a member’s API key or a signed-in member session, 401 membersOnly otherwise.

Estimated annual output of every tracked solar project, modelled with PVGIS (members)

Annual GWh and capacity factor for each solar project in the Saudi tracker, the GCC tracker and the captive segment, fixed at the optimal tilt and on a single-axis tracker, from PVGIS yields at the town or region centroid (never the plant), with totals by tracker and stage. Modelled, not measured. Members only: send a member’s API key (keys are issued to free members at /account/api), or call it from this site while signed in. Without either the answer is 401 membersOnly, with the reason in English and Arabic and a link to join; when a key cannot be checked the answer is 503 keyUnverified, never an anonymous one.

One project’s estimated annual output, with its tracker’s totals by stage

Clean-energy equipment imports into the GCC by product, year and partner

PV cells and modules, lithium-ion cells, wind turbines, static converters, electrolysis machines and large transformers, 2015 onward, by product group, year and the five largest partners. Derived from UN Comtrade: aggregates only, and no CSV, because the upstream terms do not allow the rows to be republished as published.

Clean-energy equipment flows into the GCC by importer, exporter, product and year

PV cells and modules, lithium-ion cells, liquid-filled transformers, static converters, wind turbines and electrolysis machines imported by each GCC state from every exporter, 2017 onward, from CEPII BACI (reconciled from UN Comtrade, FOB, current US dollars). Etalab Open Licence 2.0: CSV is offered with the source named. broad marks a row whose HS code holds more than the product named.

GCC greenhouse gas emissions by source, country, sector and year

Climate TRACE by sector, the Climate Watch historical series, and Our World in Data per-person and intensity figures, each row naming its source. National aggregates only; the methods differ and are never summed.

The oil price outlook: model path, fan and benchmarks

Brent today; the model’s monthly path for 24 months under current policy, anchored to the EIA outlook blended with the futures strip (with the unanchored structural path beside it), with a fixed, seeded Monte Carlo fan; the balance and OECD stocks behind it; the EIA Short-Term Energy Outlook and the futures strip beside it; World Bank and IMF benchmarks; the inventory–price calibration with its fit statistics; and what changed since the previous outlook. Modelled scenario analysis, not a forecast.

Five production paths compared

Hold current policy, gradual and accelerated increases, a deeper cut and a market-share push, each with its monthly and annual paths and a summary: price, Saudi exports, oil revenue, fiscal balance against the IMF breakeven, market share, spare capacity, net present value and the US shale response.

One preset production path, in full

One preset under any shocks, with every monthly and annual variable and its difference from current policy. CSV for members.

Run a production scenario, with Monte Carlo and the frontier

A preset or a custom path, any parameter, any shocks, and optionally a Monte Carlo run and the frontier search. Validated strictly and bounded; counts as five requests (X-RateLimit-Cost: 5). Custom paths, the frontier, Monte Carlo and CSV are for members (an API key or a signed-in session).

The near-term model scored against history

The near-term model run from mid-2014, early 2017, early 2020, early 2022 and early 2024 on the EIA outlook of the time, against the Brent that followed: the anchored path (the default), the unanchored structural model, no change and the outlook itself. Mean absolute errors by horizon, every method on the same months.

Every dataset, and whether it can be downloaded whole

Each dataset with its licence and, where a file is allowed, the size, row count, as-of date and ETag of its CSV and JSON. Datasets whose upstream terms do not allow redistribution say why. 12 of 35 are available.

A whole dataset as one CSV or JSON file, with its licence manifest

The rows of one dataset and a manifest naming the publisher and licence behind each column group (in the JSON; the CSV's first line links to it). Strong ETag: send If-None-Match to get 304. A full file counts as 10 requests, a 304 as one. Refused with 403 and the reason where the upstream licence forbids redistribution. No row carries a plant location.

Every weekly brief published, newest first

The current weekly brief

One week’s brief at its permanent address

Every published report, newest edition first

One report: caption, quoted definitions, sources and preview pages

The figures are as filed on contentUpdated; the live dashboards are separate endpoints and may read differently. The PDF and data pack are member downloads, named by their route.

Ranked matches across datasets, series, insights and projects

Model Context Protocol over Streamable HTTP

JSON-RPC over POST, stateless, answered as JSON. Read-only tools over the catalogue, the registers, the trackers, the mirrored series, the change ledger, the schedule, the brief, the report library and the model outputs. Every tool result carries source, asOf and citation (see the Citation schema), and a note where a figure is modelled. A refusal keeps the JSON-RPC envelope, with the limit or the key error in error.data. Tools and the citation contract: docs/MCP.md.

No server-sent-event stream

Answers 405 with Allow: POST, DELETE, OPTIONS: the endpoint never pushes.

End a session

The endpoint keeps no session, so there is nothing to release.

A 1200 × 630 share card with the current figures

A PNG, cached for thirty minutes. Not metered: cards are embedded by pages and link previews.

Thermodynamic properties from CoolProp’s reference equations of state

A separate Python function, so it is not metered and takes no key. Reaction enthalpies are per mole of the named product, decomposed into formation and sensible terms, and checked against published values before they are displayed. Errors answer with a matching status and are never cached.

The OpenAPI 3.1 document for every public route

Request a data licence

Filed for review; the owner is notified. Terms are agreed after the request has been read. Five requests per address per ten minutes.

This API as a Postman collection, generated from the OpenAPI document

Postman Collection v2.1, one folder per tag and one request per operation, with example values. Set the apiKey variable to send a key; leave it empty to call without one.

File a request under the Saudi Personal Data Protection Law

Access, a copy, correction, deletion, withdrawal of consent, or something else. Stored and the owner notified; the answer goes to the email address given. Five requests per address per ten minutes.

The contact form

The only place an enquiry is written. A market-entry enquiry also sends its target markets, home country, offer, references, needs and the size of the work, and is answered once, automatically, by email with an opportunity snapshot from the site’s data. Eight enquiries of any type per address in ten minutes, of which five may be market-entry.

Ask for coverage the site does not have yet

Two kinds of request. sector or place: the "I need this" button on a coming sector or place; the slug must be registered, one request per visitor per item is kept, a signed-in member’s request is linked to their account, and one address may send twenty in ten minutes. request: a request posted to the data-requests board (/data/requests) by a signed-in member, with a title (120 characters at most), details (1,000), one to three registered sectors and places, up to three topics, how soon it is needed and how it is signed; it is shown once an admin approves it. Five per member an hour, ten per address in ten minutes.

Vote for a request on the data-requests board

A signed-in member’s vote: one per member per request, taken back by sending it again, or set outright with voted. Only approved requests take votes. Sixty votes and unvotes per member in ten minutes.

Ask for a request on the board as a custom brief

A signed-in member asks for a request to be answered for them. It reaches the company’s inbox as one enquiry, linked to the request and carrying the organisation of the member’s verified work email; the member is told a proposal will follow. No price is quoted. Asking again for the same request returns the first enquiry. Five per member an hour.

Join the RV Plus and RV X materials list, with double opt-in

The confirmation link: sends the visitor to the confirmation page

Confirm a subscription from the confirmation page

The unsubscribe link: opens the page that confirms the removal

Leave the list, from the page or by one-click from a mail client

Whether the signed-in member already receives the weekly update

The one-field weekly update: double opt-in for an email address, or a member's one click on their own address

Read a signed-in member's CV (a PDF) into the application's fields

Apply as a specialist (a signed-in member)

Send a question to Renewable Vision's analysts

RV Analyst: a question answered from this site’s data (members)

Requires a signed-in member session. Streams newline-delimited JSON: text as it arrives, a line per data read, then the sources used.

Whether the site assistant can answer now (docs/ASSISTANT.md)

The site assistant: a visitor’s question answered from the site’s pages and data

For the site’s own widget. Streams newline-delimited JSON: text as it is written, the cards the answer shows (pages, membership, an enquiry form, offers), then done. 20 questions in 10 minutes and 120 a day per address, and a site-wide daily cap.

The Discover deck: cards for the site’s trackers, maps and projects, with live figures

For the site’s own Discover deck (docs/ASSISTANT.md). Each card carries one figure from the loader its page reads and the date that figure is true as of; quick guesses carry three choices, one of them the real figure. The same for every reader; no cookie is read. Nothing paid is ever a card.

A member download: a report PDF or a data pack

Requires a signed-in member session; answers with a short-lived signed URL.