Skip to main content

agentdata

PyPI License Python Commands

One Python client and CLI over 141 public datasets — company registries, sanctions lists, procurement awards, drug approvals — with no API keys and no accounts.

Government data holds the decisive facts about companies, but it is scattered across nearly a hundred public APIs, each with its own pagination, rate limits, and undocumented quirks. agentdata puts 141 of those datasets behind one interface: a pure-standard-library client and CLI across 21 jurisdictions. Every upstream gotcha we hit live is already pinned — politeness and caching are built in.

Install

python -m pip install agentdata

For a reproducible install, pin the release: python -m pip install agentdata==0.3.36.

Prefer not to touch PyPI? Install straight from a release tarball:

python -m pip install https://github.com/dicaria/agentdata/archive/refs/tags/v0.3.36.tar.gz

Or via git (pin a tag for reproducible installs):

python -m pip install git+https://github.com/dicaria/agentdata.git@v0.3.36

Or track the latest release (convenience for agents and scripts — a fresh release does not trigger a reinstall under the same URL, so pass --force-reinstall when you want the new one):

python -m pip install --force-reinstall https://github.com/dicaria/agentdata/releases/latest/download/agentdata-latest.tar.gz

Two API families

Family Where it runs Credentials Cost
Enrichment Locally — the SDK calls public government / open-data APIs from your machine none free
Corpus Hosted service operated by dicaria credentials issued by dicaria per service agreement

Most commands are enrichment: they need no configuration, no keys, no account. Corpus commands are marked in the docs and require credentials issued by dicaria under a separate service agreement — contact contact@dicaria.com.

What can you ask it?

Commands follow <domain> <source>_<dataset> — one command per upstream dataset, parameters kept under their upstream names. Every row below works as agentdata <domain> <command> … from the shell, or c.<domain>.<command>(…) from Python.

Question Commands
Is this company sanctioned? legal csl_screening_list · legal co_sic_sanctions · legal wb_debarred_firms · legal ca_sema_sanctions
Do consumers complain about this company? legal cfpb_complaints · legal cfpb_suggest_company
Who owns or controls it? company gleif_direct_parent · company no_brreg_roller · company fr_recherche_search
Did it win public contracts? procurement br_pncp_contracts · procurement ungm_contract_awards · procurement wb_procnotices
Is its drug or device approved — or recalled? healthcare fda_drug_approvals · healthcare gb_mhra_alerts · healthcare fda_drug_recalls
What does this facility or fleet emit? esg climatetrace_sources · esg thetis_mrv_datasets · esg paris_mou_detentions
Pull a company card from a national registry company ch_zefix_firm · company co_rues_companies · company kr_hometax_biz_status · company kz_gbd_ul_companies · company cz_ares_ekonomicke_subjekty · company in_sebi_intermediaries
Has its broker been expelled, or its regulator fined it? legal in_sebi_orders · company in_sebi_default_brokers
How big is the country it operates in? economy wb_wdi_values · economy eurostat_table · economy fred_series
Convert an EUR amount, or read a bilateral trade flow economy ecb_fx_rates · economy un_comtrade_trade

Quick start

from agentdata import Client

c = Client()  # zero config: enrichment commands work immediately

c.healthcare.fda_drug_recalls(search='recalling_firm.exact:"SV Labs Toronto Corporation"')
c.company.gleif_lei_records(lei="5493001KJTIIGC8Y1R12")           # LEI -> entity identity card (GLEIF)
c.company.ch_zefix_firm_search(name="siemens")                    # Swiss commercial registry (Zefix)
c.esg.climatetrace_sources(owner_ids="E100000001492", year=2023)  # owner -> facility-level emissions
c.legal.csl_screening_list(name="VTB BANK")                       # sanctions screening (US CSL)
c.research.openalex_works(search="vaccine", ror="01xdqrp08")
c.procurement.br_pncp_contracts(data_inicial="20260901", data_final="20260930", pagina=1)
c.security.osv_vulns(package="lodash", ecosystem="npm", version="4.17.15")
c.economy.wb_wdi_values(country="CHN", indicator="NY.GDP.MKTP.CD", date="2020:2023")  # World Bank indicator values
c.economy.ecb_fx_rates(currency="USD", start="2026-10-01", end="2026-10-31")  # euro reference rate (1 EUR = X)

The same commands from the shell — nine entry points, agentdata plus one per domain:

agentdata healthcare rxnav_rxcui_by_name --name atorvastatin
agentdata company gleif_lei_records_search --filter-entity-legal-name "Siemens" --page-size 3
agentdata legal csl_screening_list --name "VTB BANK"
agentdata esg climatetrace_sources --owner-ids E100000001492 --year 2023
agentdata procurement br_pncp_contracts --data-inicial 20260901 --data-final 20260930 --pagina 1
agentdata economy wb_wdi_values --country CHN --indicator NY.GDP.MKTP.CD --date 2020:2023

If a domain entry-point command (company, legal, …) collides with another tool on your machine, python -m agentdata <domain> … is the equivalent invocation.

Corpus commands use the same shape with hosted credentials:

c2 = Client(base_url="https://…", api_key="mk_live_…")  # PAT issued by dicaria
c2.company.read(id=1476, level="tier2")

Show me a response

Real output of agentdata healthcare rxnav_rxcui_by_name --name atorvastatin — every command returns this shape:

{
  "ok": true,
  "domain": "healthcare",
  "tool": "rxnav_rxcui_by_name",
  "input": { "name": "atorvastatin" },
  "from_cache": false,
  "reason": "RxNav normalization: drug name 'atorvastatin' → RxCUI 83367 (ingredient level)",
  "result": {
    "rxcui": "83367",
    "normalized_name": "atorvastatin",
    "tty": "IN"
  },
  "evidence": [
    {
      "quote": "RxCUI 83367 = atorvastatin",
      "url": "https://rxnav.nlm.nih.gov/REST/rxcui/83367/properties.json"
    }
  ],
  "source": {
    "provider": "rxnav",
    "execution": "local",
    "observed_at": "2026-11-02T03:28:22.213Z"
  },
  "request_id": "3f343e2f-3b08-46e8-ac69-8ee05adce548",
  "jurisdiction": "US"
}

A plain-language reason, evidence rows with a checkable quote and source URL, provenance in source, the issuing authority in jurisdiction, and a request_id for support — your code parses one shape across all datasets. Cached responses are identical, with from_cache: true.

Why not just call the APIs yourself?

You can — and then you get to rediscover what is already pinned here:

  • Quirks are pre-solved, not rediscovered. Every command encodes traps we hit against the live API: anti-forgery token dances, Socrata parameters that are silently ignored, registries that clamp your page size without an error.
  • One envelope across all 141 commands. Query echo, reason, evidence, source metadata, jurisdiction — your code parses one shape.
  • Upstream parameter names, verbatim. What the official API docs call a parameter is what the SDK takes — no invented vocabulary to unlearn.
  • Polite by default. Per-source rate limits are enforced before every request (rate-limits ledger), and a cache hit costs no rate budget.
  • Zero dependencies. Python 3.10+ standard library only.

Coverage

141 datasets · 97 upstream providers · 21 jurisdictions: US 41 · global 40 · EU 15 · UK 12 · Canada 5 · Colombia 3 · India 3 · Türkiye 3 · Australia 2 · Switzerland 2 · Czechia 2 · Guernsey 2 · Norway 2 · New Zealand 2 · Brazil 1 · Finland 1 · France 1 · Ireland 1 · Jersey 1 · Korea 1 · Kazakhstan 1.

Domain Commands Sources
company 32 GLEIF, SEC EDGAR, FDIC, USAspending, TED, VIES, Zefix (CH), Brreg (NO), YTJ (FI), RUES (CO), Hometax (KR), ARES (CZ), SEBI intermediaries (IN), GBD_UL (KZ), GFSC (GG), JFSC (JE), ROR
healthcare 31 FDA approvals, recalls & shortages, ClinicalTrials.gov, RxNav, DailyMed, UK MHRA, Health Canada, EUDAMED, RASFF & Safety Gate (EU), TGA (AU), Europe PMC, MeSH
legal 27 US sanctions (CSL, OCC), eCFR, Federal Register, CourtListener, LDA filings, DG COMP, UK CMA & Electoral Commission, The Gazette, SEBI orders (IN), MDB debarment (WB/AfDB/IDB), Canada SEMA, CFPB complaints, SIPRI
economy 18 World Bank WDI, Eurostat, ECB rates, FRED, BLS, WHO xMart, UN Comtrade, ILOSTAT, BIS, IMF, OECD, EU Comext
esg 12 Climate TRACE, EITI, EU ETS (EUTL), THETIS-MRV, EPA FRS, Paris MoU, EU Air Safety List
research 10 OpenAlex, NIH RePORTER, NSF, Crossref, UKRI GtR, iCite, bioRxiv, OpenCitations
procurement 7 PNCP (BR), SECOP II (CO), UNGM, World Bank, NY Authorities / MTA / OGS (US)
security 4 OSV, CISA KEV, ENISA EUVD

Caching

Every response is cached in a per-user SQLite cache shared across processes — cache hits cost no rate budget, and entry lifetimes follow the per-source TTL table in the rate-limits ledger; immutable lookups (e.g. drug name → RxCUI) are cached permanently. A fresh install in a new virtual environment will reuse entries written by earlier runs on the same machine — that is by design.

Default %LOCALAPPDATA%\agentdata\cache.db (Windows) · ~/.cache/agentdata/cache.db (macOS/Linux)
Override AGENTDATA_CACHE_DIR env var · --cache-dir (CLI)
Bypass / clear --no-cache (CLI) · no_cache=True (Python) · delete the file

Documentation

License and terms

  • The code in this repository is licensed under the license in LICENSE.
  • The data returned by the SDK is governed by the terms of each upstream source; the SDK grants no data rights. See TERMS.md.

Contact

Metadata

Release files for agentdata 0.3.36

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agentdata 0.3.36
File Size Uploaded Provenance Actions
agentdata-0.3.36.tar.gz 380.9 kB With provenance Details for agentdata-0.3.36.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for agentdata 0.3.36
File Interpreter ABI Platform Actions
agentdata-0.3.36-py3-none-any.whl Python 3 none any Details for agentdata-0.3.36-py3-none-any.whl

Total release size: 845.8 kB

Release files / agentdata-0.3.36.tar.gz

Download URL agentdata-0.3.36.tar.gz
Size 380.9 kB
Tags Source
SHA-256 checksum
How to use checksums
7463cc8c0c7d30f692dd37badb1ea64e4d78c7ce36bc5c5c7554633f6ca99a78
BLAKE2b-256 checksum
How to use checksums
e2c9c9f151988207a121aac5714da26279a779ec028bb28278bfe5b44fd5d4b9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

Release files / agentdata-0.3.36-py3-none-any.whl

Download URL agentdata-0.3.36-py3-none-any.whl
Size 464.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
70c6e0fca2a05e6dab31057d656908799e43ebc323ce9cee9c4883c129f54922
BLAKE2b-256 checksum
How to use checksums
3677195c9c17f3bd10e475a262154e06b7a61b69397782082d2dd30263a88949
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

Security for agentdata 0.3.36

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for agentdata-0.3.36.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page