API Reference

A REST API over the AltDataEU datasets. Requests are authenticated with a bearer key and return JSON. The API is included in the Quant Desk plan; a 7-day trial key with lower limits is available from the pricing page.

Base URL: https://www.altdataeu.com/api/v1. Data is updated daily and coverage varies by country.

curl -H "Authorization: Bearer $ALTDATAEU_API_KEY" \
  "https://www.altdataeu.com/api/v1/meetings?limit=2"

Authentication

Send your key as a bearer token: Authorization: Bearer et_live_.... Quant Desk subscribers get a key automatically; manage keys in the API dashboard.

A key works only while its owner has an active plan with API access. If the subscription ends, the key stops working.

Paging, filters, sorting

  • limit (default 100, max 1,000): rows per page.
  • offset (default 0): rows to skip. Follow meta.next_offset until it is null.
  • sort=column:asc|desc: sort by any column of the dataset. Rows are always returned in a deterministic order, so paging is stable.
  • column=value: exact-match filter on any column of the dataset. Unknown columns return 400.
{
  "meta": { "dataset": "altdataeu-meetings-v1", "results": 100, "limit": 100, "offset": 0, "next_offset": 100 },
  "data": [ ... ]
}

Corporate entities also accept ticker, isin and lei filters and return a security array (ticker, ISIN, LEI, match confidence) for entities with an accepted mapping. Mapping covers a subset of entities and is still growing.

Limits

  • Quant Desk: 10,000 requests per day, 120 per minute, 5-row samples.
  • 7-day trial key: 500 per day, 15 per minute, 5-row samples.
  • Successful responses include X-RateLimit-Remaining-Minute and X-RateLimit-Remaining-Day. Over the limit you get 429 with Retry-After.
  • CSV export: 5 rows without an account, 5 on the free plan, 10,000 on paid plans (/api/v1/export/csv?table=meetings).

Errors

400Unknown parameter or column, or a value in the wrong format. The message lists the allowed columns.
401Missing, invalid, expired or revoked key.
403The key owner is not on a plan with API access. The body includes an upgrade link.
404Unknown dataset.
429Rate limit exceeded.

MCP

AI assistants that support MCP over SSE can connect to https://www.altdataeu.com/api/mcp with the same bearer key. The query_dataset tool accepts the same dataset, limit, offset, sort and filters as the REST API and applies the same limits.

API Datasets

Every dataset is served by /api/v1/<dataset>. The columns below can be used as filters and sort keys.

Corporate Entities/api/v1/corporate-entities

Parent corporate entities. Responses include a `security` array (ticker, ISIN, LEI) for entities with an accepted mapping.

idnamesectorheadquarters_countrycreated_attickerisinlei

Lobbying Entities/api/v1/lobbying-entities

Lobbying register entries (EU and national registers).

idcorporate_entity_idregister_sourcesource_register_idname_in_registerdeclared_spend_mindeclared_spend_maxreporting_yearcreated_atcurrencyfte_lobbyists

Politicians/api/v1/politicians

Politicians and officials who appear in meeting logs.

idfull_namejurisdictionroleparty_affiliationcreated_atrevolving_door_flag

Politician Committees/api/v1/politician-committees

Committee memberships of politicians.

politician_idcommittee_name

Legislative Dossiers/api/v1/legislative-dossiers

Legislative dossiers.

idjurisdictiondossier_referencetitlestatuscommittee_in_chargecreated_at

Meetings/api/v1/meetings

Meetings between lobbying entities and politicians, as published in official logs.

idlobbying_entity_idpolitician_idmeeting_datetopicexplicit_dossier_idcreated_atinitiated_byfirst_seen_attopic_hash

Corporate Contracts/api/v1/corporate-contracts

Contracts linked to corporate entities.

corporate_entity_idgrantradar_contract_idamountaward_datedescriptioncreated_at

Corporate Insider Trades/api/v1/corporate-insider-trades

Insider transactions linked to corporate entities.

corporate_entity_idinsidereu_trade_idexecutive_nametransaction_typevaluetrade_datecreated_at

Revolving Door Alerts/api/v1/revolving-door-alerts

Possible revolving-door matches between lobbyists and former politicians.

idlobbyist_nameconfidence_scorelobbying_entity_idpolitician_idcreated_at

Procurement Contracts (TED)/api/v1/procurement-contracts

Public procurement award notices (TED).

idlobbying_entity_idwinner_name_rawbuyer_nameawarded_amountawarded_currencyaward_datesource_urlcreated_at

Sample data

Real extracts from the production database, with source references, so you can check the data before you subscribe.

EU procurement awards, last 12 months (CSV)

A 5-row sample of real TED contract awards with source links. Ticker, ISIN and LEI only where an accepted mapping exists.

Same extract (Parquet)

The same 5 rows as Parquet, for pandas, Polars or DuckDB.

Lobbying register sample (CSV)

A 5-row sample of real lobbying register records with the time each row was first stored.

Python walkthrough (notebook)

Loads the procurement extract, aggregates it by month and currency, and finds mapped securities.