Skip to main content

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.

Quick start

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.
This is a synchronous API. The results are returned directly in the HTTP response. Use limit and offset to paginate larger result sets.

Endpoint

Method: GET /api/v1/company/news/

Base URL

https://api.akta.pro

Authentication

Pass your API key in the x-api-key request header. -H "x-api-key: YOUR_API_KEY"
Do not expose production API keys in client-side code, public repositories, screenshots, or shared documentation. The examples below use a placeholder key.

Sample request

curl -G "https://api.akta.pro/api/v1/company/news/" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "company=tesla" \
  --data-urlencode "start_date=2026-03-01" \
  --data-urlencode "end_date=2026-05-05" \
  --data-urlencode "limit=10" \
  --data-urlencode "offset=1" \
  --data-urlencode "blacklisted=wokelo.ai"

Request reference

Query parameters

ParameterTypeRequiredDescription
companystringYesCompany permalink or valid company URL for which news articles should be fetched. Example: tesla.
start_datestringNoStart date for the news timeframe, formatted as YYYY-MM-DD.
end_datestringNoEnd date for the news timeframe, formatted as YYYY-MM-DD.
categorystringNoComma-separated list of news categories to include. Category names must be URL-encoded when sent in a raw query string.
limitintegerNoMaximum number of news articles to return in the current response.
offsetintegerNoNumber of records to skip before returning results. Use this with limit for pagination.
blacklistedstringNoComma-separated list of publisher domains to exclude from results. Include the publisher domain only, for example wokelo.ai.

Filtering by selected categories

Use category when you only want specific types of company events. Multiple categories should be passed as a comma-separated string.
curl -G "https://api.akta.pro/api/v1/company/news/" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "company=tesla" \
  --data-urlencode "start_date=2026-03-01" \
  --data-urlencode "end_date=2026-05-05" \
  --data-urlencode "limit=2" \
  --data-urlencode "offset=1" \
  --data-urlencode "category=Capital Markets & Transactions,Strategic Developments,Leadership & Governance,Workforce & Talent" \
  --data-urlencode "blacklisted=wokelo.ai"

Response

A successful response returns a status, article array, count of records in the current response, total matching articles, and pagination metadata.
{
  "status": "success",
  "data": [
    {
      "ai_summary": "Tesla, GE Vernova, and IREN are highlighted as key energy stocks for watching, with Tesla involved in electric vehicles and energy systems, GE Vernova in electricity generation across multiple segments, and IREN operating bitcoin mining data centers. These companies represent diverse sectors within the energy industry.",
      "type": "Equity Fund-Raising",
      "url": "https://www.defenseworld.net/2026/04/28/energy-stocks-to-keep-an-eye-on-april-26th.html",
      "title": "Energy Stocks To Keep An Eye On – April 26th",
      "company_name": "Tesla",
      "publisher": "defenseworld",
      "published_date": "2026-04-28 05:05:05",
      "author": "Defense World Staff",
      "countries": ["USA", "CHN", "AUS"],
      "sentiment": "Neutral",
      "company_names": [
        {
          "name": "Tesla",
          "website": "http://tesla-pa.com/"
        },
        {
          "name": "GE Vernova",
          "website": "https://www.gevernova.com"
        },
        {
          "name": "IREN",
          "website": "https://iren.com"
        }
      ],
      "primary_tag": "Equity Fund-Raising",
      "original_language": "EN",
      "secondary_tags": ["Market Indices Performance"],
      "newsworthiness_impact": "Medium",
      "primary_industry": "Retail Supply + DER/Virtual Power Plant Bundles (Solar, Storage, DR)",
      "secondary_industry": [
        "Electrical Systems O&M (Substations, Transformers, Switchgear, Protection & Controls)",
        "Risk Management & Hedging for Renewables (Price/Volume/Shape Risk, VaR)"
      ],
      "scraped_text": "Tesla, GE Vernova, and IREN are the three Energy stocks to watch today..."
    }
  ],
  "count": 1,
  "total": 15,
  "limit": 2,
  "offset": 1
}

Top-level response fields

FieldTypeDescription
statusstringRequest status. Successful requests return success.
dataarrayArray of company news article objects.
countintegerNumber of article objects returned in the current response.
totalintegerTotal number of articles matching the request filters.
limitintegerMaximum number of articles requested for the current response.
offsetintegerNumber of records skipped before the current response.

Article object fields

FieldTypeDescription
ai_summarystringAI-generated summary of the article.
typestringEvent type assigned to the article.
urlstringSource article URL.
titlestringArticle headline.
company_namestringPrimary company associated with the article.
publisherstringPublisher or source domain label.
published_datestringPublication timestamp returned by the API.
authorstringArticle author, when available.
countriesarray of stringsCountries associated with the article.
sentimentstringSentiment classification for the article. Example: Positive, Neutral.
company_namesarray of objectsCompanies mentioned in the article, with name and website where available.
primary_tagstringPrimary news category or event tag assigned to the article.
original_languagestringOriginal language code for the article. Example: EN.
secondary_tagsarray of stringsAdditional categories or event tags assigned to the article.
newsworthiness_impactstringEstimated impact level of the article. Example: Medium.
primary_industrystringPrimary industry classification associated with the article.
secondary_industryarray of stringsAdditional industry classifications associated with the article.
scraped_textstringExtracted article text.

Pagination

Use limit and offset together to paginate through matching articles.
Page 1: limit=10&offset=0
Page 2: limit=10&offset=10
Page 3: limit=10&offset=20
The response includes both count and total. Use count to understand how many records were returned in the current response, and total to understand how many records match the filters overall.

Common monitoring use cases

Portfolio adverse signal monitoring

Fetch legal, compliance, layoff, leadership change, governance, and workforce-related news for a portfolio company.
curl -G "https://api.akta.pro/api/v1/company/news/" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "company=brex" \
  --data-urlencode "category=Legal & Regulatory,Leadership & Governance,Workforce & Talent" \
  --data-urlencode "limit=25"

Capital markets and transaction monitoring

Track financing, transaction, strategic development, and governance events for a target company.
curl -G "https://api.akta.pro/api/v1/company/news/" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "company=tesla" \
  --data-urlencode "category=Capital Markets & Transactions,Strategic Developments,Leadership & Governance" \
  --data-urlencode "start_date=2026-03-01" \
  --data-urlencode "end_date=2026-05-05" \
  --data-urlencode "limit=10"

Implementation notes

  • Use company for the target company identifier and add a date range when monitoring a defined period.
  • Use category to narrow results to event types that matter for the workflow.
  • Use blacklisted to exclude irrelevant or low-value publishers.
  • Use limit and offset for pagination rather than requesting a large result set at once.
  • Store url, title, published_date, publisher, primary_tag, sentiment, and ai_summary for most monitoring dashboards.
  • Store scraped_text only when downstream workflows need full article text.