Stage Brazil CVM Filings Metadata with Kedro

Building Kedro CVM filings nodes? Call apicvm from a Python dataset loader: resolve → list → persist IDs. Kedro orchestrates; apicvm supplies filings metadata.

The problem

Research pipelines that materialize Brazilian filing inventories need versioned catalogs with stable document IDs — not one-off notebook scrapes.

Solution flow

Kedro node → Bearer auth → /v1/documents → catalog dataset → downstream transform

Node sketch

import os, requests

BASE = os.environ["APICVM_URL"]
H = {"Authorization": f"Bearer {os.environ['APICVM_KEY']}"}

def fetch_dfp_meta(ticker: str = "PETR4", year: int = 2024):
    return requests.get(
        f"{BASE}/v1/documents",
        headers=H,
        params={"ticker": ticker, "type": "DFP", "year": year, "perPage": 50},
    ).json()["data"]

Current limitations

Kedro does not query apicvm natively — use Python/HTTP
PDF download is a separate GET /v1/documents/:id/file step
Extraction remains async via callback (Pro)

Next steps

Ready to integrate?

Get an API key and start querying Brazilian CVM filings programmatically.

Read the API docs Get API key