dashboard

Get Top Entities

Just the ordered list of top entities for a slice — no time series.

A lightweight helper the frontend uses to populate entity pickers. Streams NDJSON, then returns the ranked entity names.

post/api/descriptive/top-entities

Request

  • Base URL: https://tradedashboard.eu (the document declares no server; this is the origin it was published from)
  • URL: https://tradedashboard.eu/api/descriptive/top-entities
  • Auth: none declared

Query parameters

entity_level'partner' | 'reporter'

Dimension to rank: 'partner' (trading partners) or 'reporter' (EU member states).

flow'Imports' | 'Exports'

Trade flow to rank entities by.

ninteger nullable

Number of top entities to return. Defaults to the body's n_top when omitted.

Request body

reporterstring

Declaring entity: an EU member state, an EU candidate country, Northern Ireland ('XI'), or one of the three aggregate presets ('European Union', 'Euro area', 'EU candidate countries'), or a predefined reporter group name.

reporter_membersstring[] nullable

Explicit member countries for a custom reporter group. Each entry must be an EU member state, EU candidate country, or Northern Ireland. When more than one member is supplied the frame is aggregated into a synthetic group named after 'reporter'.

partner_setstring

Named partner preset, e.g. 'non-EU countries', 'EU countries', 'all countries', or a predefined partner group.

partnersstring[] nullable

Explicit partner-country list that overrides 'partner_set' when present.

period_startstring

Inclusive start of the analysis window, ISO month 'YYYY-MM'.

period_endstring

Inclusive end of the analysis window, ISO month 'YYYY-MM'. Defaults to roughly three months ago — the latest period Eurostat typically has fully reported.

frequencystring

Resampling frequency for the series: 'month', 'quarter' or 'year'.

n_topinteger

Number of top entities (by volume/value) to break out individually in charts.

include_otherboolean

Bundle entities outside the top-N into a single 'Other' bucket.

remove_outliersboolean

Drop extreme unit-price outliers before computing weighted-average prices.

midpointstring nullable

Split point 'YYYY-MM' for the Pattern Shifts tab: the window is cut in two here and the before/after change per entity is reported. Defaults to the middle of the period when omitted.

langstring

Language for translated labels in the response (en, de, fr, es, it, ro).

prodcom_codestring nullable

Specific PRODCOM dataset code to pin for the Net Import Reliance and Trade Intensity tabs, when a single CN code maps to several. Ignored elsewhere.

Response

Successful Response

Changes

No recorded changes to this operation across all 1 revision of this API.