API Reference

The AltDataEU API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

The base URL for all API requests is https://api.altdataeu.com

Authentication

Authenticate your account by including your secret API key in the request. You can manage your API keys in the Dashboard. Your API keys carry many privileges, so be sure to keep them secure.

Authentication to the API is performed via HTTP Bearer Auth. Provide your API key as the bearer token value.

Pagination

All top-level API resources have support for bulk fetches via "list" API methods. These list API methods share a common structure, taking at least these two parameters: limit and starting_after (cursor).

  • limit (default 100, max 1000): A limit on the number of objects to be returned.
  • starting_after: An object ID that defines your place in the list.

API Datasets

Instead of maintaining dozens of disparate endpoints, all of our data is accessible via a unified dynamic router: /api/v1/[dataset].

Corporate Entities

The master list of parent corporate entities involved in lobbying, public procurement, and insider trading.

Lobbying Entities

Detailed records of regional lobbying entities registered in the EU and national transparency registers.

Politicians & Policymakers

Comprehensive database of European politicians, MEPs, and Ministers who are targets of lobbying efforts.

Legislative Dossiers

Track the lifecycle of legislative dossiers, drafts, and implemented laws across Europe.

Lobbyist-Politician Meetings

The core regulatory velocity metric. Links a lobbying entity to a politician, often referencing specific dossiers.

Corporate Contracts Map

Entity-resolved mapping between corporate entities and their public procurement (TED) contract wins.

Corporate Insider Trades Map

Entity-resolved mapping between corporate entities and executive insider trading activity.

Revolving Door Alerts

Flags instances when former politicians join lobbying firms or corporate boards.

Raw Insider Trades

Raw executive insider trading data (buys/sells) across European exchanges.

Major Holdings (5%+)

Track significant institutional ownership changes and threshold crossings across Europe.

Public Procurement (TED)

Streams awarded public procurement contracts and grants from Tenders Electronic Daily (TED).

Institutional Due Diligence & Data Pack

Download verified technical specifications, legal provenance documentation, and sample datasets for institutional due diligence, backtesting, and procurement review.

Master Data Catalog Overview

Full suite: TED procurement, executive insider trades, 5%+ holdings, lobbying, and LEI resolution (PDF).

Technical Data Dictionary

Schema specification, field types, ISIN/LEI mapping, and methodology (PDF).

Institutional One-Pager

Executive product brief for PMs & quants with cross-dataset alpha use cases and pricing (PDF).

Compliance & DDQ Summary

Data provenance, zero-MNPI legal declaration, and GDPR statement (PDF).

1,000-Row Sample Dataset

Standardized statutory lobbying records with point-in-time timestamps (CSV).

Historical Backtest Sample

Multi-period historical factor dataset for quantitative testing (CSV).

Authentication Example

# With cURL, you pass the token in the Authorization header
curl https://api.altdataeu.com/v1/meetings \
  -H "Authorization: Bearer alt_live_x89f..."

List Meetings Request

curl -G https://api.altdataeu.com/v1/meetings \
  -H "Authorization: Bearer alt_live_..." \
  -d limit=3 \
  -d country="DE"

Response

{
  "object": "list",
  "data": [
    {
      "id": "mtg_eu_829312",
      "object": "meeting",
      "date": "2025-10-12",
      "politician": {
        "id": "pol_98234",
        "name": "Klaus W."
      },
      "lobbyists": [
        {
          "name": "TechAdvocacy Partners EU",
          "tr_id": "8492019482-12"
        }
      ],
      "dossiers_discussed": ["AI Act"]
    }
  ],
  "has_more": true,
  "next_cursor": "mtg_eu_829312"
}