Skip to main content
GET
Company News

Overview

The Company News Monitoring API returns the latest news articles for a given company. Each result is enriched with an AI-generated summary, event classification, publisher metadata, sentiment, company mentions, geography, industry tags, and scraped article text. Results are returned synchronously in the HTTP response.

Endpoint Details

  • Method: GET
  • Endpoint: /api/v1/company/news/
  • Base URL: https://api.akta.pro

Authentication

Pass your API key in the x-api-key request header.

Request

Query Parameters

string
required
Company permalink or valid company URL for which news articles should be fetched. Example: tesla.
string
Start date for the news timeframe, formatted as YYYY-MM-DD.
string
End date for the news timeframe, formatted as YYYY-MM-DD.
string
Comma-separated list of news categories to include. Category names must be URL-encoded when sent in a raw query string.
integer
Maximum number of news articles to return in the current response.
integer
Number of records to skip before returning results. Use this with limit for pagination.
string
Comma-separated list of publisher domains to exclude from results. Include the publisher domain only, for example patch.com, observer.com, examiner.com.

Response

Successful Response Fields

Returns a JSON object with the following structure:
string
Request status. Successful requests return success.
array
Array of company news article objects.
integer
Number of article objects returned in the current response.
integer
Total number of articles matching the request filters.
integer
Maximum number of articles requested for the current response.
integer
Number of records skipped before the current response.

Article Object Fields

string
AI-generated summary of the article.
string
Event type assigned to the article.
string
Source article URL.
string
Article headline.
string
Primary company associated with the article.
string
Publisher or source domain label.
string
Publication timestamp returned by the API.
string
Article author, when available.
array of strings
Countries associated with the article.
string
Sentiment classification for the article. Example: Positive, Neutral.
array of objects
Companies mentioned in the article, with name and website where available.
string
Primary news category or event tag assigned to the article.
string
Original language code for the article. Example: EN.
array of strings
Additional categories or event tags assigned to the article.
string
Estimated impact level of the article. Example: Medium.
string
Primary industry classification associated with the article.
array of strings
Additional industry classifications associated with the article.
string
Extracted article text.

Authorizations

x-api-key
string
header
required

Query Parameters

company
string
required

Company permalink or valid company URL for which news articles should be fetched. Example: tesla .

start_date
string

Start date for the news timeframe, formatted as YYYY-MM-DD .

end_date
string

End date for the news timeframe, formatted as YYYY-MM-DD .

category
string

Comma-separated list of news categories to include. Category names must be URL-encoded when sent in a raw query string.

limit
integer

Maximum number of news articles to return in the current response.

offset
integer

Number of records to skip before returning results. Use this with limit for pagination.

blacklisted
string

Comma-separated list of publisher domains to exclude from results. Include the publisher domain only, for example patch.com , observer.com , examiner.com .

Response

200 - application/json

Response 200

status
string

Request status. Successful requests return success .

data
object[]

Array of company news article objects.

count
integer

Number of article objects returned in the current response.

total
integer

Total number of articles matching the request filters.

limit
integer

Maximum number of articles requested for the current response.

offset
integer

Number of records skipped before the current response.

ai_summary
string

AI-generated summary of the article.

type
string

Event type assigned to the article.

url
string

Source article URL.

title
string

Article headline.

company_name
string

Primary company associated with the article.

publisher
string

Publisher or source domain label.

published_date
string

Publication timestamp returned by the API.

author
string

Article author, when available.

countries
object

Countries associated with the article.

sentiment
string

Sentiment classification for the article. Example: Positive , Neutral .

company_names
object

Companies mentioned in the article, with name and website where available.

primary_tag
string

Primary news category or event tag assigned to the article.

original_language
string

Original language code for the article. Example: EN .

secondary_tags
object

Additional categories or event tags assigned to the article.

newsworthiness_impact
string

Estimated impact level of the article. Example: Medium .

primary_industry
string

Primary industry classification associated with the article.

secondary_industry
object

Additional industry classifications associated with the article.

scraped_text
string

Extracted article text.