Cross-company comparison
0.1 credits / lookupRetrieves a single financial metric for all US public companies that reported it in a given period, enabling cross-company comparison and ranking. Well suited for questions like which companies had the highest revenue in a given year or how total assets compare across an industry.
Use when
You want to compare or rank one reported figure across many companies for one period.
Not for
A single company's full history (use the single-metric or full-facts lookup).
Cost
0.1 credits / lookup
What it accepts
Set these inside the intent when you run it.
The financial line item to compare across companies, such as revenue or net income.
The fiscal year or quarter to compare, such as 2023 or Q1 2024.
What you get back
One row per reporting company containing the metric value, the period covered, and the source filing, across all filers for that period.
Run it
Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Company Filings & Fundamentals (US) skill will route from your intent instead.)
curl -X POST "https://skill.askfaro.com/skills/sec-filings/run" \
-H "Authorization: Bearer $FARO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"intent":{"operation":"frames","metric":"revenue","period":"2023"}}'Example requests
- ›Which US companies had the highest revenue in 2023?
- ›Compare total assets across all public companies for Q1 2024
- ›Rank companies by net income for fiscal year 2022