# Rank US public companies by 2024 revenue

**Use case:** 

Lists the 25 US companies with the highest revenue for calendar 2024, taken from the XBRL financial data they filed with the SEC. Each row has the company, CIK, reported value, fiscal period and a link to the filing on EDGAR. Change the metric or period to screen on net income, assets or another year.

## Input

```json
{
  "mode": "screen",
  "metric": "revenue",
  "company": "AAPL",
  "period": "CY2024",
  "period_type": "any",
  "order": "desc",
  "limit": 25
}
```

## Output

```json
{
  "company": {
    "label": "Company",
    "format": "text"
  },
  "value": {
    "label": "Value",
    "format": "number"
  },
  "unit": {
    "label": "Unit",
    "format": "text"
  },
  "metric": {
    "label": "Metric",
    "format": "text"
  },
  "period_end": {
    "label": "Period end",
    "format": "text"
  },
  "period_type": {
    "label": "Period",
    "format": "text"
  },
  "form": {
    "label": "Form",
    "format": "text"
  },
  "filed": {
    "label": "Filed",
    "format": "text"
  },
  "verify_url": {
    "label": "Verify on SEC.gov",
    "format": "link"
  }
}
```

## How it works

### 1. Sign up on Apify or log in

The SEC EDGAR Financial Data & Company Screener (XBRL) Actor is ready to run with the inputs already set for "Rank US public companies by 2024 revenue". [Sign up or log in](https://console.apify.com/create-task-from-example/rVrSfChUhZxvplccQ) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Rank US public companies by 2024 revenue" task

The SEC EDGAR Financial Data & Company Screener (XBRL) Actor will start running based on the input automatically. You can also change all the input fields, like mode, financial metric, and more, to match your specific use case.

### 3. Receive the "Rank US public companies by 2024 revenue" output

Monitor the progress in real time. You will be notified as soon as your dataset is complete and ready for review. Each result includes data such as company, value, unit, and more.

### 4. Integrate into your workflow

The final output is delivered in JSON, CSV, or Excel format, ready to be plugged into your workflow. You can also [run the "Rank US public companies by 2024 revenue" task via API](https://apify.com/groundtruth/sec-edgar-financial-data.md).

## FAQ

### Where do the revenue figures come from?

The SEC revenue ranking task reads the XBRL financial data companies file with the SEC (the EDGAR frames API). Every row links to the filing it came from, so each number can be checked on sec.gov.

### Can I rank on something other than revenue?

The SEC revenue ranking task takes any metric the screener supports, such as net income or total assets, and any calendar period like CY2023. Set metric and period in the input.

### How much does it cost?

The SEC revenue ranking task costs $0.002 per company returned, so the default 25 rows cost about $0.05.

### Can an AI agent run this task?

The SEC revenue ranking task runs through the Apify API or the Apify MCP server with any Apify token, including a prepaid token an AI agent buys over x402 at agi.apify.com.

## About this Actor

This example demonstrates how to use [SEC EDGAR Financial Data & Company Screener (XBRL)](https://apify.com/groundtruth/sec-edgar-financial-data.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/groundtruth/sec-edgar-financial-data.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/groundtruth/sec-edgar-financial-data.md

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).