v57

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-07-2161198428.4 KB
Instrument Data

Get News

Retrieves news items with optional filtering by security IDs, time range, publisher, type, and text query.

get/v1/news

Query parameters

page_sizeinteger

The number of items to return per page. Only used when page_token is not provided.

page_tokenstring byte

Base64URL-encoded pagination token

Token for retrieving the next or previous page of results. Contains encoded pagination state; when provided, page_size is ignored.

fromstring

Inclusive start timestamp. Accepts YYYY-MM-DD or RFC3339 datetime.

tostring

Inclusive end timestamp. Accepts YYYY-MM-DD or RFC3339 datetime.

include_publishersstring

Comma-separated list of publishers to include (mutually exclusive with exclude_publishers).

exclude_publishersstring

Comma-separated list of publishers to exclude (mutually exclusive with include_publishers).

news_type'NEWS' | 'PRESS_RELEASE'

News item classification.

Filter by news type.

search_querystring

Free-text query matched against title/text and associated security IDs.

instrument_idsstring[]

Comma-delimited instrument identifiers to filter by.

sectorsstring[]

Comma-separated sector values to filter by.

Response

News items

Example response

{
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero"
  },
  "data": [
    {
      "image_url": "https://images.financialmodelingprep.com/news/apple-reports-first-quarter-results-20250130.jpg",
      "instruments": [
        {
          "instrument_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "name": "Apple Inc.",
          "symbol": "AAPL"
        }
      ],
      "news_type": "NEWS",
      "published_at": "2025-01-30T16:30:00.000000000Z",
      "publisher": "Business Wire",
      "site": "businesswire.com",
      "text": "CUPERTINO, Calif.--(BUSINESS WIRE)--Apple today announced financial results...",
      "title": "Apple reports first quarter results",
      "url": "https://www.businesswire.com/news/home/20250130261281/en/Apple-reports-first-quarter-results/"
    }
  ]
}