Skip to Content

Getting Started

Use the API when you want source-backed SEC filing data over HTTPS. Use the MCP server when an agent should call the same tools through a model-native interface.

Get An API Key

Create a key from the EdgarParser site or use the shared playground page for cache-only demo calls.

Send A Request

curl "https://www.edgarparser.com/api/metric?ticker=AAPL&year=2025&quarter=4&metric_name=Revenue&date_type=Q" \
  -H "Authorization: Bearer $EDGAR_API_KEY"

Inspect Source Context

Use source_ref, filing URLs, document sections, and table metadata in the response before presenting a number as final.

⚠️

Cache-only tools will not run a cold SEC parse for anonymous playground traffic. Sign up for an API key when the requested ticker or period is outside the prewarmed demo scope.

Base URL

https://www.edgarparser.com

Authentication

Send keys as a Bearer token:

Authorization: Bearer YOUR_KEY

Most public GET routes also accept a key query parameter for simple curl usage, but Bearer auth is the canonical integration path.

Good First Calls

  • get_metric: one financial metric for one filing period.
  • get_metric_series: the same metric across multiple periods.
  • list_metrics: exact metric names available in a filing cache.
  • get_filings: filing metadata and accession discovery.
  • describe_filing: cache state and artifact availability for a filing.