Skip to main content
GET
News Signals API

Overview

The News API fetches news articles filtered by company, industry, date range, sentiment, type, and news score. Each result is enriched with an AI-generated summary, event classification, publisher metadata, sentiment, company mentions, geography, industry tags, named entities (people, locations, products, and events mentioned in the article) and the full article text. Results are returned in the API response.

Endpoint Details

  • Method: GET
  • Endpoint: /api/v1/news

Authentication requirements

  • Include a valid API key in the x-api-key request header.

Request

Request Parameters

URL Parameters

string
Website (e.g. https://canva.com) or company UUID returned by the Company Search API.
string
Website (e.g. https://canva.com) or company UUID returned by the Company Search API.Note: You cannot use both company and primary_company in the same request. Use primary_company to return only articles where the specified company is primary company featured in the news article.
string
Comma separated list of industry codes to filter articles by. Use industry search endpoint to fetch the list of industry codes for a given industry topic.
string
Topic name to search articles. Allows open-ended topic name. Eg. Crude oil price developments
string
Searches articles based on the title entered.Note: a request can only have one of query or title as parameters and NOT both.
string
Start of the date range, formatted as YYYY-MM-DD. Non-enterprise plans are limited to a 6-month lookback.
string
End of the date range, formatted as YYYY-MM-DD.Default = today
integer
Maximum number of news articles to return.Default = 10Max value = 100
integer
Number of results to skip before returning records. Use with limit for pagination.Default = 0
boolean
Accepts boolean. True will group similar articles from the same event.
string
Filter by news score tier. Accepted values: High, Medium, Low , allDefault = all
string
Filters articles based on the country of the event. Comma separated list of 3 letter ISO country codes. View full list of ISO country codes.
string
Comma separated list of publisher domains to exclude.
string
Filter by news type. View full list of news categories.Default = all
string
Filter by sentiment. Accepted values: positive, negative, neutral, all.Default = all
string
Comma separated list of people names.
string
Comma separated list of locations.
string
Comma separated list of product names
string
Comma separated list of event names
string
Comma separated list of NAICS codes. View full list of NAICS codes.
string
Comma separated list of SIC codes. View full list of SIC codes.
string
Comma separated list of IPTC codes. View full list of IPTC codes.
string
Comma separated list of IAB codes. View full list of IAB codes.

Response

Successful Response Fields

Returns a JSON object with the following structure:
integer
Total number of articles available based on the filters set
integer
Limit applied to the request.
integer
Offset applied to the request.
float
Number of credits consumed
integer
Number of articles returned in the data array.
array
List of news article objects.