You can access the SEC EDGAR Financial Data & Company Screener (XBRL) programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "G8J5yQ3Z15cDXGpiL"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/groundtruth~sec-edgar-financial-data/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-groundtruth-sec-edgar-financial-data",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/groundtruth~sec-edgar-financial-data/runs": {
      "post": {
        "operationId": "runs-sync-groundtruth-sec-edgar-financial-data",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/groundtruth~sec-edgar-financial-data/run-sync": {
      "post": {
        "operationId": "run-sync-groundtruth-sec-edgar-financial-data",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "screen",
              "company"
            ],
            "type": "string",
            "description": "'screen' compares one metric across every US public company for a period. 'company' returns one company's history of that metric.",
            "default": "screen"
          },
          "metric": {
            "title": "Financial metric",
            "type": "string",
            "description": "revenue, net_income, assets, liabilities, equity, cash, operating_income, gross_profit, eps_basic, eps_diluted, operating_cash_flow, capex, long_term_debt, inventory, goodwill, rd_expense, shares_outstanding, and more. A raw XBRL tag such as 'Revenues' also works.",
            "default": "revenue"
          },
          "company": {
            "title": "Company (ticker or CIK)",
            "type": "string",
            "description": "Required in 'company' mode. A ticker like AAPL, or a CIK number."
          },
          "period": {
            "title": "Period",
            "type": "string",
            "description": "Used in 'screen' mode. Calendar year like CY2024, or a quarter like CY2024Q1. Balance-sheet metrics are adjusted automatically.",
            "default": "CY2024"
          },
          "period_type": {
            "title": "Period type",
            "enum": [
              "any",
              "quarterly",
              "half_year",
              "nine_month",
              "annual",
              "instant"
            ],
            "type": "string",
            "description": "Filters by reporting period length. A 10-Q reports both the quarter AND the year-to-date figure, so without this you can accidentally compare a 3-month number to a 9-month one.",
            "default": "any"
          },
          "min_value": {
            "title": "Minimum value",
            "type": "integer",
            "description": "Only companies at or above this figure. Negative values are legal (losses)."
          },
          "max_value": {
            "title": "Maximum value",
            "type": "integer",
            "description": "Only companies at or below this figure."
          },
          "order": {
            "title": "Order",
            "enum": [
              "desc",
              "asc"
            ],
            "type": "string",
            "description": "Sort direction. 'Largest first' ranks companies by value descending; in company mode it orders by most recent period first.",
            "default": "desc"
          },
          "limit": {
            "title": "Number of records",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "1 to 200.",
            "default": 50
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

SEC EDGAR Financial Data & Company Screener OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for SEC EDGAR Financial Data & Company Screener (XBRL) from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

SEC EDGAR Financial Data & Company Screener (XBRL) API in Python

SEC EDGAR Financial Data & Company Screener (XBRL) API in JavaScript

SEC EDGAR Financial Data & Company Screener (XBRL) API through CLI

SEC EDGAR Financial Data & Company Screener (XBRL) API

SEC EDGAR Financial Data Scraper

kelvinosse/sec-edgar-scraper

Scrape SEC EDGAR filings and XBRL financial data for public companies.

Kelvin

Company Financial Fundamentals — SEC XBRL Metrics API

nexgendata/company-financial-fundamentals-sec

Track company financial fundamentals from SEC XBRL from SEC EDGAR — parsed, source-linked JSON for analysts, funds and AI agents.

NexGenData

SEC EDGAR Scraper

trendlab/sec-edgar-scraper

Get SEC EDGAR data for any US public company: filings, financial statements (XBRL), and insider trades. Clean, AI-ready JSON. No API key needed.

Cheoljae Lee

SEC EDGAR Scraper - Filings, XBRL Financials & Search

renzomacar/sec-edgar-scraper

Scrape SEC EDGAR for any US public company: filings (10-K, 10-Q, 8-K, Form 4), XBRL financial statements, and full-text filing search. Official government data straight from SEC, no API key, pay per result. Feed financial models, screeners, risk monitoring and investment research.

Renzo Madueno

SEC EDGAR US Company Filings & Financial Facts Scraper

dromb/sec-edgar-us

Search SEC EDGAR companies, browse by exchange, and extract company profiles with recent filings and XBRL financial facts.

Dmitriy Gyrbu

SEC EDGAR Financials — official XBRL Company Facts API, no logi

pappy-dev/sec-edgar-financials

Fetch structured financial time series (revenue, assets, net income, EPS, and 500+ XBRL concepts) for any U.S. public company via the official SEC EDGAR XBRL Company Facts API (data.sec.gov). Input a ticker or CIK, get years of filed data as clean rows. No login, no PDF/HTML scraping.

Backyard Tools

SEC EDGAR Scraper — Filings & Financial Data

commanding_hotdog/sec-edgar-scraper

Extract SEC EDGAR filings — 10-K, 10-Q, 8-K, S-1. Search by ticker, keyword, form type. XBRL financial data. Free SEC API. Company financial research & investment analysis.

qingwa

EDGAR Company Filings & XBRL Fundamentals Extractor

gp005/edgar-xbrl-fundamentals

SEC EDGAR API: extract SEC EDGAR filings (10-K, 10-Q, 8-K, 13-F) and XBRL financial data — revenue, EPS, assets — for any US public company by ticker or CIK. Structured JSON from the official data.sec.gov API; no login, no paywall.

Geo

SEC XBRL Financial Frames — Structured Fundamentals

nexgendata/sec-xbrl-financial-frames

Track XBRL financial-statement frames from SEC EDGAR — parsed, source-linked JSON for analysts, funds and AI agents.

NexGenData

SEC EDGAR Financial Facts

datamule/sec-edgar-financial-facts

Give a ticker or CIK, get every reported XBRL financial fact for any US public company from the official SEC EDGAR company-facts API (data.sec.gov) — revenue, assets, EPS, cash, liabilities and every us-gaap + dei concept, flattened to one analysis-ready row per observation. No API key.