Query Tools

Natural language query to energy data (MaStR, ENTSO-E, SMARD)

Execute natural language queries against German energy data sources including MaStR (Marktstammdatenregister), ENTSO-E Transparency Platform, and SMARD.de. Supports multi-source data aggregation and complex queries without SQL knowledge.

Data Sources:

  • MaStR: German registry of all energy installations (PV, wind, storage, etc.)
  • ENTSO-E: European electricity grid transparency data
  • SMARD: German electricity market data

Use Cases:

  • Ad-hoc data exploration ("How much PV capacity in Bavaria?")
  • Quick questions without SQL knowledge
  • Multi-source data aggregation
  • Portfolio analysis and market research

Response Time: Typically 2-8 seconds (includes LLM reasoning)

post/api/query/ask

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/query/ask
  • Auth: none declared

Query parameters

tokenstring

Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.

Request body

querystring required

Natural language question in German or English

explainboolean

Include detailed reasoning and data sources used

tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "query": "Wie viele Solaranlagen gibt es in Heidelberg mit mehr als 10 kWp?"
}

Response

Successful query execution with answer and metadata

successboolean
answerstring

Natural language answer

dataobject

Structured data result

sourcesstring[]

Data sources used

metadataobject

Execution metadata

Example response

{
  "success": true,
  "answer": "Total PV capacity in Bavaria: 31,604,839.789 kW",
  "sources": [
    "mastr_db"
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.