---
title: "News articles"
method: GET
path: "/v1beta1/news"
tags: ["News"]
---

# News articles

`GET /v1beta1/news`

Returns the latest news articles across stocks and crypto. By default, returns the latest 10 news articles.

## Query parameters

- `start` string, date-time
- `end` string, date-time
- `sort` 'asc' | 'desc'
- `symbols` string
- `limit` integer
- `include_content` boolean
- `exclude_contentless` boolean
- `page_token` string

## Response `200`

OK

- NewsResp
  - `news` News[], required
    - `author` string, required — Original author of news article.
    - `content` string, required — Content of the news article (might contain HTML).
    - `created_at` string, date-time, required — Date article was created (RFC-3339).
    - `headline` string, required — Headline or title of the article.
    - `id` integer, required — News article ID.
    - `images` NewsImage[], required — List of images (URLs) related to given article (may be empty).
      - `size` 'thumb' | 'small' | 'large', required — Possible values for size are thumb, small and large.
      - `url` string, uri, required — URL to image from news article.
    - `source` string, required — Source where the news originated from (e.g. Benzinga).
    - `summary` string, required — Summary text for the article (may be first sentence of content).
    - `symbols` string[], required — List of related or mentioned symbols.
    - `updated_at` string, date-time, required — Date article was updated (RFC-3339).
    - `url` string, uri, nullable — URL of article (if applicable).
  - `next_page_token` string, nullable, required — Pagination token for the next page.

## Other responses

- `400` — One of the request parameters is invalid. See the returned message for details.
- `401` — Authentication headers are missing or invalid. Make sure you authenticate your request with a valid API key.
- `403` — The requested resource is forbidden.
- `429` — Too many requests. You hit the rate limit. Use the X-RateLimit-... response headers to make sure you're under the rate limit.
- `500` — Internal server error. We recommend retrying these later. If the issue persists, please contact us on [Slack](https://alpaca.markets/slack) or on the [Community Forum](https://forum.alpaca.markets/).

---

[API](https://skmtc.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/revisions/62e3378bb273/schema)