EU Transparency Register Organisation ID Portfolio Status Event Monitor

Watch a book of EU Transparency Register identificationCodes and emit typed REMOVED / APPEARED / LAST_UPDATE_CHANGED / CATEGORY_CHANGED events when the official open-data organisations XML changes — not another full-register lobbyist directory dump, not an HTML scrape of the Transparency Register UI, and not unpaid LobbyFacts as primary.

What this Actor does

1. Takes your watchlist (identificationCodes — exact official keys).
2. In live mode, downloads the official EU open-data organisations XML once:
   • https://transparency-register.europa.eu/odplastorganisationxml_en (data.europa.eu Transparency Register dataset distribution; redirects to ODP XML/latest)
3. Matches only watched identificationCodes (portfolio mode — not “download all ~15–18k orgs as product rows”).
4. Diffs against a durable Key-Value Store checkpoint.
5. Pushes only material status/update events for organisations on your book (PPE), plus one non-billable RUN_STATUS health row.

First observation of an identificationCode is baseline only (no charge). Quiet days ≈ $0 product charges.

Coverage honesty (read this)

In scope	Out of scope
Official EU Transparency Register organisations open-data XML	HTML scrape of transparency-register.europa.eu search UI
Exact identificationCode portfolio watch	Full-register lobby dump billed per org row
Presence = present vs absent from active export	Invented “suspended” statuses not in the file
Material lastUpdateDate / registrationCategory updates	Unpaid LobbyFacts scrape / US LDA filing twin (#21)
Periodic official export cadence	Guaranteed intra-day mutations

Matching honesty: this Actor matches identificationCode only (durable official key). It does not fuzzy-match organisation names. Cite EU Transparency Register + export date (as_of / exportDate).

Input

Field	Notes
identificationCodes	Official IDs (0801162959-21). Exact match.
signalGroups	presence (APPEARED/REMOVED), update (LAST_UPDATE / CATEGORY).
sourceMode	fixture (default — Store health) or live (official XML; no API key).
emitFixtureDemoEvents	Default false. Only enable for local demos; Store auto-tests must stay false.
maxRunSeconds	Default 300 — XML is ~100 MB.

Output events (billable)

event_type	When
EUTR_APPEARED	Watched ID absent → present on export
EUTR_REMOVED	Watched ID present → absent from export
EUTR_LAST_UPDATE_CHANGED	lastUpdateDate changed while still present
EUTR_CATEGORY_CHANGED	registrationCategory changed while still present

Every successful run also pushes RUN_STATUS with billable: false (FIXTURE_HEALTH / MONITOR_IDLE / CATCHUP_COMPLETE / HEALTH_OK).

Pricing (PPE)

Event	Price
eutr-org-status-event-delivered	$0.02 ($20 / 1k)
apify-actor-start	$0.00005

You pay when an organisation on your watchlist has a material presence/update event and we deliver it. Not charged: baselines, quiet books, duplicates, invalids, RUN_STATUS, fixture health.

Modes

• Fixture (default): no network; emits RUN_STATUS / FIXTURE_HEALTH only → 0 product charges (Store daily auto-test safe).
• Live: official EU TR open-data XML — no key required.

Legal

EU Transparency Register open data on data.europa.eu for reuse (Commission reuse notice). Cite EU Transparency Register + export date. Default product fields: identificationCode, names, category, dates. Not a LobbyFacts substitute. Do not invent statuses absent from the export.

Not this product

• jungle_synthesizer/eu-transparency-register-scraper, crawlerbros/eu-lobbying-transparency-register-scraper — full-register dumps / research extracts (different job; 0–1 MAU).
• US LDA filing watch (#21) — different statute / jurisdiction.
• HTML scrape of the Transparency Register UI; unpaid LobbyFacts scrape as primary.

Example input (live baseline)

{
  "identificationCodes": ["0801162959-21", "7410939793-88"],
  "sourceMode": "live",
  "signalGroups": ["presence", "update"],
  "resumeFromCheckpoint": true,
  "emitFixtureDemoEvents": false,
  "maxRunSeconds": 300
}

First live run stores baselines only. Subsequent scheduled runs emit events when presence or material fields flip on the book.