{"uid":"cap_PjsHuAQkuNhTREibQwRe8","slug":"datanexusai-eurostat-energy-series-51fd9e96","name":"DataNexusAI Eurostat Energy Series","description":"Public data API for SEBRA payments, PTP road accidents, EU agri-food prices, Eurostat energy (+ ETS), and trade/market analytics. Paid data endpoints use x402 (USDC micropayments). HTML docs at `/api/` are free and are intentionally omitted from this OpenAPI document so discovery scanners do not probe them as paid resources.\n\nMachine-readable discovery: `https://api.datanexusai.org/openapi.json`, `https://api.datanexusai.org/llms.txt`, `https://api.datanexusai.org/.well-known/x402`.\n\nHuman docs: `/docs` and `/api/`.","url":"https://api.datanexusai.org/api/v1/energy/series?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["dataset_id","geo"],"properties":{"geo":{"type":"string","example":"BG","description":"ISO2 country code"},"freq":{"type":"string","example":"A","description":"Frequency filter (A/Q/M)"},"unit":{"type":"string","example":"KGOE_TEUR","description":"Unit filter"},"limit":{"type":"integer","example":100,"description":"Max points (default 200, max 2000)."},"period_to":{"type":"string","example":"2024","description":"Inclusive period upper bound"},"dataset_id":{"type":"string","example":"nrg_ind_ei","description":"Eurostat dataset id"},"period_from":{"type":"string","example":"2010","description":"Inclusive period lower bound"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"geo":"BG","count":1,"endpoint":"energy_series","dataset_id":"nrg_ind_ei","observations":[{"obs_value":180.5,"time_period":"2020"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rODfuZ_k-9swiuIvCu3ws","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves time-series energy statistics from Eurostat datasets for a specified EU/EEA country, with optional frequency, unit, and period filters.","exampleAgentPrompt":"Can you pull the Eurostat energy intensity dataset nrg_ind_ei for Bulgaria, annual frequency, in KGOE_TEUR units, from 2010 to 2024?","exampleUseCases":[{"title":"EU energy efficiency trend analysis","prompt":"Get me the annual energy intensity figures for Germany from the Eurostat dataset nrg_ind_ei, in KGOE_TEUR units, from 2005 to 2023."},{"title":"ETS emissions data for policy research","prompt":"Fetch quarterly ETS-related energy data for France from the Eurostat dataset nrg_chdd_a covering the period 2015 to 2022, up to 500 observations."},{"title":"Comparative energy stats for a specific year range","prompt":"I need the Eurostat energy balance series nrg_bal_s for Poland, annual frequency, between 2018 and 2023 — can you grab that?"}],"resultDescription":"Returns a JSON object containing the queried country code, dataset ID, total observation count, and an array of time-period/value pairs (e.g. [{\"time_period\": \"2020\", \"obs_value\": 180.5}]), filtered by the specified frequency, unit, and period bounds.","failureModes":["Invalid or unsupported dataset_id returns an error or empty result","Unsupported ISO2 country code returns no observations","Invalid frequency or unit filter silently returns 0 observations","period_from/period_to out of available data range returns empty observations array","Payment failure via x402 if USDC balance is insufficient","limit exceeding 2000 is rejected or capped"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable Eurostat energy time-series data for EU/EEA countries — particularly energy intensity, efficiency, balance, or ETS indicators — with flexible filtering by country, period, unit, and frequency. Prefer it over scraping Eurostat's web interface or bulk downloads when you need a targeted, programmatic slice of data per country or dataset.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:36:58.773Z","isFirstParty":false,"canonicalSlug":"datanexusai-eurostat-energy-series-51fd9e96"}