API
ESC to close

Peers Analysis

Dynamically fetch competitors and calculate aggregated sector/industry averages and medians across thousands of custom metrics.

GET https://data.businessquant.com/peers?{identifier}&cols={cols}&api_key={api_key}

Parameters

The Peers Analysis endpoint allows you to dynamically fetch competitors and calculate aggregated sector or industry averages and medians. You must provide an API key, and exactly one Identifier (Ticker, Sector, or Industry).

Parameter Description
api_key
Required
Your unique API key for authentication.
ticker
Conditional Identifier
Stock Ticker to dynamically find peers in the same industry.
Format: ticker=AAPL
sector
Conditional Identifier
Broad market sector categorization.
Format: sector=Consumer%20Defensive
(must be URL-encoded)
industry
Conditional Identifier
Specific industry categorization.
Format: industry=Software%20-%20Application
(must be URL-encoded)
cols
Optional
Comma-separated list of database metrics to extract.
Format: cols=Gross%20Profit%20(Quarter)
(must be URL-encoded)
Example cURL Request 
curl -X GET "https://data.businessquant.com/peers?sector=Technology&cols=Gross%20Profit%20(Quarter),Net%20Income%20(Quarter)&api_key=YOUR_API_KEY"
Sample Response 
{
    "metadata": {
        "filter_used": "sector",
        "industry": "Software - Application",
        "sector": "Technology",
        "total_peers": 725
    },
    "summary_statistics": {
        "median": {
            "Gross Profit (Qtr)": 73216500.0,
            "Net Income (Qtr)": 375452.5
        },
        "average": {
            "Gross Profit (Qtr)": 810535536.4634147,
            "Net Income (Qtr)": 303048036.12666667
        }
    },
    "data": [
        {
            "ticker": "NVDA",
            "cik": 1045810,
            "companyname": "Nvidia Corp",
            "companyname_short": "Nvidia",
            "sector": "Technology",
            "industry": "Semiconductors",
            "Market Cap": 4833800019470.21,
            "Gross Profit (Qtr)": 51093000000.0,
            "Net Income (Qtr)": 42915000000.0
        },
        {
            "ticker": "AAPL",
            "cik": 320193,
            "companyname": "Apple Inc.",
            "companyname_short": "Apple",
            "sector": "Technology",
            "industry": "Consumer Electronics",
            "Market Cap": 3886582059736.88,
            "Gross Profit (Qtr)": 69231000000.0,
            "Net Income (Qtr)": 42097000000.0
        },
        {
            "ticker": "MSFT",
            "cik": 789019,
            "companyname": "Microsoft Corp",
            "companyname_short": "Microsoft",
            "sector": "Technology",
            "industry": "Software - Infrastructure",
            "Market Cap": 3121911683715.82,
            "Gross Profit (Qtr)": 55295000000.0,
            "Net Income (Qtr)": 38458000000.0
        },
        ...
    ]
}

Endpoint Variations

Below are the distinct ways to formulate your request depending on the identifier you use. You can copy these directly into your application.

1. By Ticker 
https://data.businessquant.com/peers?ticker=AAPL&cols=Gross%20Profit%20(Quarter)&api_key=YOUR_API_KEY
2. By Sector 
https://data.businessquant.com/peers?sector=Technology&cols=Gross%20Profit%20(Quarter)&api_key=YOUR_API_KEY
3. By Industry 
https://data.businessquant.com/peers?industry=Software%20-%20Application&cols=Gross%20Profit%20(Quarter)&api_key=YOUR_API_KEY