# Get Fundamentals

Get the company profile, key statistics, earnings dates, analyst targets and recommendation trend for a symbol. Annual and quarterly statement rows are grouped under income, balance_sheet and cash_flow, each with an as-of date, period type, currency code and numeric reported value.

- **Documentation:** [https://scrappa.co/docs/yahoo-finance-api/yahoo_finance_fundamentals](https://scrappa.co/docs/yahoo-finance-api/yahoo_finance_fundamentals)
- **API group:** Yahoo Finance API
- **Endpoint:** `GET https://scrappa.co/api/yahoo-finance/fundamentals`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | Ticker symbol, e.g. AAPL. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/yahoo-finance/fundamentals?symbol=AAPL"
```

## Example response

```json
{
    "symbol": "AAPL",
    "currency": "USD",
    "profile": {
        "name": "Apple Inc.",
        "sector": "Technology",
        "industry": "Consumer Electronics",
        "employees": 166000
    },
    "statistics": {
        "trailingPE": 31.2,
        "marketCap": 2980000000000
    },
    "earnings": {
        "dates": [
            "2027-01-28T00:00:00Z"
        ],
        "earnings_average": 1.85
    },
    "analyst_targets": {
        "target_mean": 215.4,
        "trend": []
    },
    "statements": [],
    "source": "yahoo_finance"
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Not found | No fundamentals were returned for the symbol. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
