Skip to main content
GET
/
api
/
v1
/
company
/
news
Company News Monitoring
curl --request GET \
  --url https://api.example.com/api/v1/company/news/ \
  --header 'x-api-key: <x-api-key>'
{
  "status": "<string>",
  "data": [
    {}
  ],
  "count": 123,
  "total": 123,
  "limit": 123,
  "offset": 123,
  "ai_summary": "<string>",
  "type": "<string>",
  "url": "<string>",
  "title": "<string>",
  "company_name": "<string>",
  "publisher": "<string>",
  "published_date": "<string>",
  "author": "<string>",
  "countries": {},
  "sentiment": "<string>",
  "company_names": {},
  "primary_tag": "<string>",
  "original_language": "<string>",
  "secondary_tags": {},
  "newsworthiness_impact": "<string>",
  "primary_industry": "<string>",
  "secondary_industry": {},
  "scraped_text": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.akta.pro/llms.txt

Use this file to discover all available pages before exploring further.

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 requirements

Pass your API key in the x-api-key request header.
-H "x-api-key: YOUR_API_KEY"

Request

Request Parameters

Header Parameters

x-api-key
string
required
API key used to authenticate the request.

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 wokelo.ai.

Response

Successful Response Fields

Returns a JSON object with the following structure:
status
string
Request status. Successful requests return success.
data
array
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.

Article Object Fields

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
array of strings
Countries associated with the article.
sentiment
string
Sentiment classification for the article. Example: Positive, Neutral.
company_names
array of objects
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
array of strings
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
array of strings
Additional industry classifications associated with the article.
scraped_text
string
Extracted article text.