{"uid":"cap_nrItGLzGMRggcSrFVP6wt","slug":"datanexusai-energy-compare-b9457411","name":"DataNexusAI Energy Compare","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/compare?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","geos"],"properties":{"freq":{"type":"string","example":"A","description":"Frequency filter"},"geos":{"type":"string","example":"BG,RO,GR,DE","description":"Comma-separated ISO2 codes (max 15)"},"unit":{"type":"string","description":"Unit filter"},"period":{"type":"string","example":"2022","description":"Period (default: latest)"},"dataset_id":{"type":"string","example":"nrg_ind_ei","description":"Eurostat dataset id"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"period":"2022","endpoint":"energy_compare","observations":[{"geo":"BG","rank":1,"obs_value":175}]}},"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_mu4RLyBWM3HEzcNaCLuxk","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":"Compares Eurostat energy indicator values across multiple EU countries for a given dataset and period, returning ranked observations per geography.","exampleAgentPrompt":"Can you compare the energy intensity indicator (dataset nrg_ind_ei) for Bulgaria, Romania, Greece, and Germany for the year 2022 and show me how they rank against each other?","exampleUseCases":[{"title":"Eastern EU energy efficiency ranking","prompt":"I need to compare energy efficiency indicators from Eurostat dataset nrg_ind_ei across Bulgaria, Romania, Hungary, Poland, and Slovakia for 2022 — which countries rank best and worst?"},{"title":"Germany vs Southern Europe energy benchmark","prompt":"Can you pull the Eurostat annual energy intensity data for Germany, Italy, Spain, Portugal, and Greece and rank them so I can see who performs best?"},{"title":"EU energy indicator monitoring for policy brief","prompt":"For a policy brief, I need a cross-country comparison of the nrg_ind_ei dataset at annual frequency for DE, FR, SE, FI, and AT covering the 2021 period — rank them by their observed values."}],"resultDescription":"Returns a JSON object containing the queried period, endpoint identifier, and a list of observations — each with a country ISO2 code, a numeric observed energy value, and an integer rank indicating relative position among the requested geographies.","failureModes":["Invalid or unknown dataset_id returns an error or empty observations","Requesting more than 15 country codes may be rejected or truncated","Invalid ISO2 country codes produce missing or empty geo entries","Unsupported period or frequency combination may return no data","Missing required parameters (dataset_id or geos) returns a 400-level error","Payment failure via x402/USDC results in a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need to cross-compare a specific Eurostat energy dataset across multiple EU member states and receive a ranked output in one call. It is best suited for comparative analytics, policy research, or dashboards that require per-country energy indicator rankings rather than a single-country time series. Prefer it over raw Eurostat API access when you want pre-ranked, normalized results and are comfortable with USDC micropayments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:36:25.040Z","isFirstParty":false,"canonicalSlug":"datanexusai-energy-compare-b9457411"}