News API - akta.pro API Documentation

News

curl --request GET \
  --url https://api.akta.pro/api/v1/news \
  --header 'x-api-key: <api-key>'

{
    "status": "success",
    "limit": 10,
    "offset": 0,
    "data": [
        {
            "title": "Canva Raises $1.5B in Secondary Transaction at $32B Valuation",
            "url": "https://example.com/canva-secondary-2024",
            "publisher": "TechCrunch",
            "published_date": "2024-03-12",
            "type": "Secondary Transactions",
            "sentiment": "positive",
            "news_score": 0.92,
            "ai_summary": "Canva completed a $1.5 billion secondary share sale led by ICONIQ Capital, valuing the design software company at $32 billion. The transaction provides liquidity to existing employees and early investors while the company continues to grow ARR past $2 billion.",
            "full_text": "Canva, the Australian design software platform, announced today the completion of a $1.5 billion secondary share sale...",
            "original_language": "en",
            "author": "Jane Doe",
            "countries": ["AUS", "USA"],
            "industries": [
                {
                    "name": "Software",
                    "code": "software",
                    "is_primary": true
                }
            ],
            "tags": [
                {
                    "name": "Secondary Sale",
                    "code": "secondary_sale",
                    "is_primary": true
                }
            ],
            "company_mentions": [
                {
                    "company_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                    "name": "Canva",
                    "website": "https://canva.com",
                    "is_primary": true
                },
                {
                    "company_id": "9c2e1d4a-1234-4567-89ab-cdef01234567",
                    "name": "ICONIQ Capital",
                    "website": "https://iconiqcapital.com",
                    "is_primary": false
                }
            ]
        }
    ]
}

GET

news

News

curl --request GET \
  --url https://api.akta.pro/api/v1/news \
  --header 'x-api-key: <api-key>'

{
    "status": "success",
    "limit": 10,
    "offset": 0,
    "data": [
        {
            "title": "Canva Raises $1.5B in Secondary Transaction at $32B Valuation",
            "url": "https://example.com/canva-secondary-2024",
            "publisher": "TechCrunch",
            "published_date": "2024-03-12",
            "type": "Secondary Transactions",
            "sentiment": "positive",
            "news_score": 0.92,
            "ai_summary": "Canva completed a $1.5 billion secondary share sale led by ICONIQ Capital, valuing the design software company at $32 billion. The transaction provides liquidity to existing employees and early investors while the company continues to grow ARR past $2 billion.",
            "full_text": "Canva, the Australian design software platform, announced today the completion of a $1.5 billion secondary share sale...",
            "original_language": "en",
            "author": "Jane Doe",
            "countries": ["AUS", "USA"],
            "industries": [
                {
                    "name": "Software",
                    "code": "software",
                    "is_primary": true
                }
            ],
            "tags": [
                {
                    "name": "Secondary Sale",
                    "code": "secondary_sale",
                    "is_primary": true
                }
            ],
            "company_mentions": [
                {
                    "company_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                    "name": "Canva",
                    "website": "https://canva.com",
                    "is_primary": true
                },
                {
                    "company_id": "9c2e1d4a-1234-4567-89ab-cdef01234567",
                    "name": "ICONIQ Capital",
                    "website": "https://iconiqcapital.com",
                    "is_primary": false
                }
            ]
        }
    ]
}

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 and the full article text. Results are returned in the API response.

Endpoint Details

Method: GET
Endpoint: /v1/news

Authentication requirements

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

Request

Request Parameters

Header Parameters

x-api-key

string

required

Your API key.

URL Parameters

company

string

Website (e.g. https://canva.com) or company UUID returned by the Company Search API.

industry

string

Industry name to filter articles by.

start_date

string

Start of the date range, formatted as YYYY-MM-DD. Non-enterprise plans are limited to a 6-month lookback.

end_date

string

End of the date range, formatted as YYYY-MM-DD.Default = today

limit

integer

Maximum number of news articles to return.Default = 10Max value = 100

offset

integer

Number of results to skip before returning records. Use with limit for pagination.Default = 0

news_score_list

string[]

Filter by news score tier. Accepted values: High, Medium, Low , allDefault = all

type_list

string[]

Filter by news type. Download Full ListDefault = all

sentiment_list

string[]

Filter by sentiment. Accepted values: positive, negative, neutral, all.Default = all

Response

Successful Response Fields

Returns a JSON object with the following structure:

total

integer

Total number of articles available based on the filters set

limit

integer

Limit applied to the request.

offset

integer

Offset applied to the request.

credits_consumed

float

Number of credits consumed

count

integer

Number of articles returned in the data array.

data

array

List of news article objects. See Article Object Fields below.

Article Object Fields

title

string

Headline of the article.

url

string

Link to the original article.

publisher

string

Name of the publishing outlet.

published_date

string

Publication date in ISO 8601 format YYYY-MM-DD.

sentiment

string

Sentiment of the article: positive, negative, or neutral.

news_score

string

Relevance and quality score of the article. Values:“high”, “medium”, “low”

ai_summary

string

AI-generated summary of the article.

full_text

string

Full body text of the article.

original_language

string

Language code of the original article. Example: en, fr.

author

string

Author of the article.

countries

array of strings

Country codes mentioned in the article.

industries

array of objects

Industries associated with the article. See Industry Object below.

types

array of objects

News types associated with the article. See Type Object below.

company_mentions

array of objects

Companies mentioned in the article. See Company Object below.

Industry Object

name

string

Industry name. Example: Software.

is_primary

boolean

true if this is the primary industry of the article.

Type Object

name

string

Tag label. Example: IPO, Layoffs.

code

string

Tag code. Example: ipo, layoffs.

is_primary

boolean

true if this is the primary type of the article.

Company Object

uuid

string

Company UUID.

name

string

Company name.

website

string

Company website URL.

is_primary

boolean

true if this is the main company the article is about.

{
    "status": "success",
    "limit": 10,
    "offset": 0,
    "data": [
        {
            "title": "Canva Raises $1.5B in Secondary Transaction at $32B Valuation",
            "url": "https://example.com/canva-secondary-2024",
            "publisher": "TechCrunch",
            "published_date": "2024-03-12",
            "type": "Secondary Transactions",
            "sentiment": "positive",
            "news_score": 0.92,
            "ai_summary": "Canva completed a $1.5 billion secondary share sale led by ICONIQ Capital, valuing the design software company at $32 billion. The transaction provides liquidity to existing employees and early investors while the company continues to grow ARR past $2 billion.",
            "full_text": "Canva, the Australian design software platform, announced today the completion of a $1.5 billion secondary share sale...",
            "original_language": "en",
            "author": "Jane Doe",
            "countries": ["AUS", "USA"],
            "industries": [
                {
                    "name": "Software",
                    "code": "software",
                    "is_primary": true
                }
            ],
            "tags": [
                {
                    "name": "Secondary Sale",
                    "code": "secondary_sale",
                    "is_primary": true
                }
            ],
            "company_mentions": [
                {
                    "company_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                    "name": "Canva",
                    "website": "https://canva.com",
                    "is_primary": true
                },
                {
                    "company_id": "9c2e1d4a-1234-4567-89ab-cdef01234567",
                    "name": "ICONIQ Capital",
                    "website": "https://iconiqcapital.com",
                    "is_primary": false
                }
            ]
        }
    ]
}

Authorizations

x-api-key

string

header

required

API key obtained from your Akta account.

Query Parameters

company

string

Website domain (e.g. 'https://canva.com') or company UUID returned by the Company Search API.

industry

string

Industry name to filter articles by.

start_date

string<date>

Start of the date range, formatted as YYYY-MM-DD. Non-enterprise plans are limited to a 6-month lookback.

end_date

string<date>

End of the date range, formatted as YYYY-MM-DD. Defaults to today.

limit

integer

default:10

Maximum number of news articles to return.

Required range: x <= 100

offset

integer

default:0

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

news_score_list

enum<string>[]

Filter by news score tier. Accepted values: High, Medium, Low, all. Default = all

Available options:

High,

Medium,

Low,

all

type_list

enum<string>[]

Filter by news type. Default = all. See https://playground.akta.pro/news-tags.csv for the list of available news tags.

Available options:

CM00,

CM01,

CM02,

CM03,

CM04,

CM05,

CM06,

CM07,

CM08,

CM09,

CM10,

CM11,

CM12,

FR00,

FR01,

FR02,

FR03,

FR04,

FR05,

FR06,

FR07,

II00,

II01,

II02,

II03,

II04,

II05,

LG00,

LG01,

LG02,

LG03,

LG04,

LG05,

LG06,

MD00,

MD01,

MD02,

MD03,

MD04,

MD05,

MD06,

MD07,

MM00,

MM01,

MM02,

MM03,

MM04,

MM05,

MM06,

MM07,

OT01,

RC00,

RC01,

RC02,

RC03,

RC04,

RC05,

RC06,

RC07,

RC08,

RK00,

RK01,

RK02,

RK03,

RK04,

RK05,

RK06,

RK07,

RK08,

SD00,

SD01,

SD02,

SD03,

SD04,

SD05,

SD06,

SD07,

SD08,

SD09,

SD10,

SD11,

WT00,

WT01,

WT02,

WT03,

WT04,

WT05

sentiment_list

enum<string>[]

Filter by sentiment. Accepted values: positive, negative, neutral, all. Default = all

Available options:

positive,

negative,

neutral,

all

Response

News articles returned

status

string

Example:

"success"

total

integer

Total matching articles available.

count

integer

Number of articles returned in the data array.

limit

integer

offset

integer

credits_consumed

number<float>

data

object[]

Show child attributes

Company Enrichment API

​Overview

​Endpoint Details

​Authentication requirements

​Request

​Request Parameters

​Header Parameters

​URL Parameters

​Response

​Successful Response Fields

​Article Object Fields

​Industry Object

​Type Object

​Company Object

Authorizations

Query Parameters

Response

Overview

Endpoint Details

Authentication requirements

Request

Request Parameters

Header Parameters

URL Parameters

Response

Successful Response Fields

Article Object Fields

Industry Object

Type Object

Company Object