# Ticker News

`GET` `/v1/news/{ticker}`

Retrieve news articles and press releases tagged to a specific ticker. Same article schema as market news but filtered to one company. Optionally filter with type=stockNews or type=pressRelease. Paginate with page and limit. Pair with quotes or profiles for a complete company snapshot page.

## Use cases

- Company-specific news feeds on security detail pages
- Event-driven research after price moves
- Alerting on material news for watchlist tickers
- NLP pipelines scoped to one issuer

## Input parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `ticker` | string | Yes | Ticker. |
| `type` | string | No | Filter by article type: stockNews or pressRelease. Omit for both. |
| `page` | integer | No | Zero-based page (default 0). |
| `limit` | integer | No | Page size, 1-250 (default 50). |

## Output parameters

| Name | Type | Description |
| --- | --- | --- |
| `ticker` | string | Ticker requested. |
| `results` | array | News articles for this page. |
| `results[].id` | string | Article id. |
| `results[].title` | string | Headline. |
| `results[].publishedAt` | string | Publication time (ISO 8601). |
| `results[].publisher` | string | Publisher name. |
| `results[].url` | string | Article URL. |
| `results[].tickers` | array | Related tickers. |
| `total` | integer | Total articles for the ticker. |
| `page` | integer | Zero-based page index. |

## Example response

```json
{
  "ticker": "AAPL",
  "results": [
    {
      "publishedDate": "2026-06-06 12:44:35",
      "publisher": "24/7 Wall Street",
      "title": "Not SpaceX: The Forgotten Satellite Stocks Quietly Plugging Into the Future of Space That Are Investible Today",
      "site": "247wallst.com",
      "text": "While Starlink soaks up every space headline, two publicly traded satellite operators have quietly turned niche networks into real businesses.",
      "url": "https://247wallst.com/investing/2026/06/06/not-spacex-the-forgotten-satellite-stocks-quietly-plugging-into-the-future-of-space-that-are-investible-today/",
      "newsType": "stockNews",
      "ticker": "AAPL",
      "id": "405b20baba513ae13c19"
    },
    {
      "publishedDate": "2026-06-06 11:30:00",
      "publisher": "Market Watch",
      "title": "Apple's WWDC will be a make-or-break moment for the company's fledgling AI strategy",
      "site": "marketwatch.com",
      "text": "Apple faces a high-stakes artificial-intelligence showcase next week when it hosts its Worldwide Developers Conference.",
      "url": "https://www.marketwatch.com/story/apples-wwdc-will-be-a-make-or-break-moment-for-the-companys-fledgling-ai-strategy-42086cc1",
      "newsType": "stockNews",
      "ticker": "AAPL",
      "id": "3e4f406c6919d2e6c1d4"
    }
  ],
  "total": 30890,
  "page": 0
}
```

## Examples

### cURL

```bash
curl "https://api.vantafin.com/v1/news/AAPL?type=pressRelease&limit=50&apiKey=$VANTAFIN_API_KEY"
```

### Python

```python
from vantafin import RESTClient

client = RESTClient("vf-live-your_api_key")

result = client.get_ticker_news("AAPL", type="pressRelease", limit=50)

print(result)
```

### JavaScript

```javascript
import { RestClient } from "vantafin";

const client = new RestClient("vf-live-your_api_key");

const result = await client.getTickerNews("AAPL", { type: "pressRelease", limit: 50 });

console.log(result);
```

### Go

```go
package main

import (
	"fmt"
	"log"

	"github.com/vantafin/vantafin-go"
)

func main() {
	client := vantafin.NewClient("vf-live-your_api_key")

	result, err := client.GetTickerNews("AAPL", vantafin.Params{"type": "pressRelease", "limit": 50})
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(result)
}
```

### Java

```java
import com.vantafin.RestClient;
import com.vantafin.Params;

public class Example {
    public static void main(String[] args) throws Exception {
        RestClient client = new RestClient("vf-live-your_api_key");

        Object result = client.getTickerNews("AAPL", Params.of().set("type", "pressRelease").set("limit", 50));

        System.out.println(result);
    }
}
```

### Ruby

```ruby
require "vantafin"

client = Vantafin::RestClient.new("vf-live-your_api_key")

result = client.get_ticker_news("AAPL", type: "pressRelease", limit: 50)

pp result
```