News

News

Fetch enriched news articles for a company or industry. Each article includes AI-generated summary, full text, sentiment, event tags, industry classifications, and resolved company mentions. Results are returned synchronously — no polling required.

get/v1/news

Request

  • Base URL: https://api.akta.pro/api
  • URL: https://api.akta.pro/api/v1/news
  • Auth: API key in header x-api-key

Query parameters

companystring

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

primary_companystring

Filter to return only articles where the specified company is the primary company featured. Cannot be used with the company parameter.

industrystring

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.

querystring

Topic name to search articles. Allows open-ended topic name. Eg. Crude oil price developments

titlestring

Searches articles based on the title entered.

start_datestring date

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

end_datestring date

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

limitinteger

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

offsetinteger

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

group_articlesboolean

Accepts boolean. True will group similar articles from the same event.

news_score_list'High' | 'Medium' | 'Low' | 'all'

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

countriesstring

Filters articles based on the country of the event. Comma separated list of ISO country codes.

blacklistedstring

Comma separated list of publisher domains to exclude.

type_liststring

Filter by news type. Download full list from https://playground.akta.pro/news-tags.csv. Default = all.

sentiment_liststring

Comma-separated list of sentiments to filter by. Accepted values: positive, negative, neutral, all. Default = all. Example: sentiment_list=positive,negative

entity_person_liststring

Comma separated list of people names.

entity_location_liststring

Comma separated list of locations.

entity_product_liststring

Comma separated list of product names.

entity_event_liststring

Comma separated list of event names.

naics_code_liststring

Comma separated list of NAICS codes.

sic_code_liststring

Comma separated list of SIC codes.

iptc_code_liststring

Comma separated list of IPTC codes.

iab_code_liststring

Comma separated list of IAB codes.

Response

News articles returned

statusstring
totalinteger

Total matching articles available.

countinteger

Number of articles returned in the data array.

limitinteger
offsetinteger
credits_consumednumber float

Example response

{
  "status": "success"
}

Changes

No recorded changes to this operation across all 1 revision of this API.