drillr.ai
API keys →

Introduction

drillr is a financial data and research API for the US, China and Japan. Beyond the financial statements, it searches the full text of filings, finds companies from a natural-language description, and publishes research signals extracted from filings, news and earnings calls. The data is built by drillr from primary sources, and every reported figure links back to the document it came from.

The same data is served two ways: a REST API for scripts and pipelines, and an MCP server for AI agents.

Ways in

REST API

REST endpoints, query parameters, JSON out. For scripts, pipelines and anything that already speaks HTTP.

https://gateway.drillr.ai/api/v2

MCP server

The same data as tools your agent can call from Claude Code, Codex, Cursor or Claude Desktop. Browser sign-in, no key to paste.

https://gateway.drillr.ai/mcp/data

One header, one request. Apple’s last four annual income statements:

curl -H "X-API-KEY: $DRILLR_API_KEY" \
  "https://gateway.drillr.ai/api/v2/income-statements?ticker=AAPL&period=FY&limit=4"

Quickstart walks through the key, the call and the response.

What you get

  • Company. Find companies from a description of what they do, or resolve any name, code or identifier to a ticker.
  • Filings. Full-text search across filings in English, Chinese and Japanese: every hit is the passage as filed, with its section, form type and filing date; the filing index carries the accession number and a deep link to the official document.
  • Signal. Conclusions drawn by drillr, not fields relayed from a vendor: industry inflections and enterprise AI adoption synthesized from earnings calls, and cross-source news storylines.
  • Events. A typed timeline of financings, deals, executive changes, corporate actions and ownership changes, every row linked to its filing.
  • Ownership. US insider trades and institutional holdings, parsed from the SEC filings themselves.
  • Executives. US executive rosters and annual compensation taken from proxy statements, with the filing that evidences each row.
  • Financials. The three statements as reported under each market’s own standard, plus precomputed valuation and quality metrics.
  • Earnings. The earnings calendar with estimates and actuals, and structured summaries of earnings calls.

What makes it different

  • Every number, searchable and traceable. Filing search indexes the full text of filings, not a fixed set of line items, so any figure a company ever filed is findable, and every number links back to the passage it was filed in. Company discovery finds companies from a description of what they do, not from a name you already know.
  • Conclusions, not relayed fields. Industry inflections, enterprise AI adoption and cross-source news storylines are conclusions drawn by drillr’s research pipeline across companies and sources, each published with the evidence it rests on.
  • Structured rows out of unstructured text. Filing narratives, earnings calls, proxy tables and news carry no schema at all. drillr extracts them into typed rows — a filing narrative becomes a classified event with its type, parties and date — each with a stable id and a link to the source.

Next steps