# Yahoo Finance News API (yahoo_finance.news)

- Canonical page: https://everyinfra.com/en/yahoo-finance-api/news
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "yahoo_finance", "action": "news", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=yahoo_finance&action=news

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | Specifies a single Yahoo Finance ticker symbol (e.g., AAPL) with required exchange suffixes retained. It does not perform full-text company name searches. The history, financials, news, analyst, and options actions process one ticker per request to retrieve historical market data, financial statements, news items, analyst coverage, or options chains. |
| limit | integer (1–) | no | not declared | The most rows to return in this call, an integer of 1 or more. The default applies when you leave it out, and a call can return fewer rows. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| publisher | platform-native meaning |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| symbol | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "yahoo_finance",
  "action": "news",
  "params": {
    "keyword": "AAPL"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "yahoo_finance",
        "action": "news",
        "params": {
            "keyword": "AAPL",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 9. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "yahoo_finance",
  "action": "news",
  "results": [
    {
      "id": "4d0a12b7-86a4-3d14-888b-abaa98270a72",
      "url": "https://finance.yahoo.com/markets/stocks/articles/investors-may-respond-apple-aapl-071245138.html",
      "title": "How Investors May Respond To Apple (AAPL) Launching Its First Foldable iPhone With On‑Device AI",
      "text": "In recent days, Apple launched its first foldable iPhone Duo alongside the iPhone 18 Pro lineup, highlighting enhanced on-device Siri AI and privacy as key features while entering the competitive foldable smartphone market. This move not only broadens Apple’s premium hardware ran…",
      "posted_at": "Sat, 26 Sep 2026 07:12:45 +0000",
      "symbol": "AAPL",
      "platform": "yahoo_finance"
    },
    {
      "id": "a090d75c-f4f1-3203-b862-179ac5b70cd8",
      "url": "https://finance.yahoo.com/markets/stocks/articles/apple-aapl-took-different-pricing-012229936.html",
      "title": "Apple (AAPL) Took a Different Pricing Approach with its New iPhones in China",
      "text": "On September 10, 2026, CNBC reported that Apple Inc. (NASDAQ:AAPL)’s iPhone Duo faces a tepid reception in China, where it is priced at 15,999 yuan, or about $2,230, positioning it above Xiaomi’s newly launched 18 Fold at 10,999 yuan but below Huawei’s trifold Mate XT2 at 19,999 …",
      "posted_at": "Sat, 26 Sep 2026 01:22:29 +0000",
      "symbol": "AAPL",
      "platform": "yahoo_finance"
    }
  ],
  "count": 9,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=yahoo_finance
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
