> ## 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.
# News Signals API
> Fetches news articles enriched with AI-generated summaries, event types, publisher metadata, sentiment, industry tags, company mentions and full article text.
## 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, named entities (people, locations, products, and events mentioned in the article) 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
Your API key.
## URL Parameters
Website (e.g. `https://canva.com`) or company UUID returned by the Company Search API.
Comma separated list of industry codes to filter articles by. Use [industry search](https://docs.akta.pro/industry-search-api) endpoint to fetch the list of industry codes for a given industry topic.
Topic name to search articles. Allows open-ended topic name. Eg. Crude oil price developments
Searches articles based on the title entered.
Start of the date range, formatted as `YYYY-MM-DD`. Non-enterprise plans are limited to a 6-month lookback.
End of the date range, formatted as `YYYY-MM-DD`.
Default = today
Maximum number of news articles to return.
Default = 10
Max value = 1000
Number of results to skip before returning records. Use with `limit` for pagination.
Default = 0
Accepts boolean. True will group similar articles from the same event.
Filter by news score tier. Accepted values: `High`, `Medium`, `Low` , `all`
Default = `all`
Filters articles based on the country of the event. Comma separated list of **3 letter ISO country codes**. [View](/country-codes) full list of ISO country codes.
Comma separated list of publisher domains to exclude.
Filter by news type. [View](/news-types) full list of news categories.
Default = `all`
Filter by sentiment. Accepted values: `positive`, `negative`, `neutral`, `all`.
Default = `all`
Comma separated list of people names.
Comma separated list of locations.
Comma separated list of product names
Comma separated list of event names
Comma separated list of NAICS codes. [View](/naics-codes) full list of NAICS codes.
Comma separated list of SIC codes. [View](/sic-codes) full list of SIC codes.
Comma separated list of IPTC codes. [View](/iptc-codes) full list of IPTC codes.
Comma separated list of IAB codes. [View](/iab-codes) full list of IAB codes.
## Response
#### Successful Response Fields
Returns a JSON object with the following structure:
Total number of articles available based on the filters set
Limit applied to the request.
Offset applied to the request.
Number of credits consumed
Number of articles returned in the data array.
List of news article objects.
```json 200 expandable wrap theme={null}
{
"status": "success",
"limit": 10,
"offset": 0,
"data": [
{
"id": 26877020,
"title": "How Canva Offline keeps productivity moving in the Philippines",
"url": "https://mb.com.ph/2026/07/01/how-canva-offline-keeps-productivity-moving-in-the-philippines",
"publisher": "",
"published_date": "2026-07-01T09:18:00",
"sentiment": "Positive",
"sentiment_score": 1,
"ai_summary": "Canva has highlighted how its Offline feature helps Filipino professionals maintain productivity despite unreliable internet connectivity and power interruptions. The article profiles Kredbylle Timbang, a brand designer in Bataan who relies on Canva Offline to continue working during power outages and meet client deadlines. The feature automatically syncs changes once connectivity is restored, allowing users to maintain creative momentum in flexible work environments.",
"full_text": "Technews How Canva Offline keeps productivity moving in the Philippines By Manila Bulletin Newsroom\n\nFor many Filipinos today, work can happen anywhere. A presentation might begin at home, get refined in a café, and be finalized between meetings later in the day. As working professionals increasingly embrace flexible work arrangements, productivity is no longer defined by where people work, but by their ability to keep work moving wherever they are. This shift has made flexibility essential. Filipinos need tools that adapt to the realities of modern work, allowing them to stay productive while on the go. In a world where ideas can happen anytime, creativity and momentum should not be limited by location or connectivity. This is the idea behind Canva Offline. Designed for today's increasingly mobile workforce, the feature allows users to continue creating and editing even when connectivity is unavailable. By making essential design tools accessible offline, Canva helps ensure that work can continue uninterrupted, empowering users to stay productive and focused. Once connectivity is restored, changes automatically sync, allowing work to continue seamlessly without losing progress. For content creator and brand designer Kredbylle Timbang, flexibility is not just a preference. It is essential to running her business. Based in Bataan, Kred works with clients remotely, develops brand identities, creates content, and manages multiple creative projects throughout the day. Like many Filipino entrepreneurs building businesses online, she has learned to navigate the challenges that come with remote work while ensuring she consistently delivers quality outputs on time. One of those challenges is something many Filipinos know all too well: unexpected power interruptions. \"Canva is the focal point of everything that I do,\" she shared. \"Power interruption is prominent here, and they often disrupt my focus and creative flow while designing.\" Before Canva Offline became available, losing connectivity often meant putting work on hold entirely. Progress stopped until power or internet service returned, creating unnecessary delays and disrupting momentum. For someone managing client deadlines and projects, those interruptions could easily affect productivity. Today, Canva Offline has become an important part of how Kred works. \"It really is a lifesaver to be able to edit offline when the power goes out unexpectedly,\" she said. \"Even without power and internet, I can continue editing without disruption. I've made it a habit to save my projects offline so I can keep working and make sure I deliver quality outputs to clients on time.\" Rather than worrying about interruptions, she can focus her energy on growing her business, serving clients, and staying creative. Her experience reflects a broader reality for many Filipinos today. As more Filipinos embrace flexible work arrangements, side hustles, online businesses, and freelance careers, productivity increasingly depends on tools that can keep work moving. For students, entrepreneurs, and creators like Kred, the ability to continue working offline provides something increasingly valuable: continuity. It allows them to stay focused on deadlines, serve clients, and bring ideas to life without losing momentum. For many Filipinos, Canva Offline is more than a convenience feature. It addresses a growing challenge in today's flexible work environment by ensuring that creativity and productivity are not dependent on a stable internet connection. In a world where work can happen anywhere, it gives users the freedom to keep moving forward, wherever inspiration or opportunity takes them.\n\nADVERTISEMENT\n\nRelated Tags",
"word_count": 548,
"original_language": "EN",
"author": "Manila Bulletin Newsroom",
"countries": [
"PHL"
],
"industries": [
{
"name": "Collaboration & Productivity Platforms (M365/Google Workspace, Email, Chat/Meetings)",
"is_primary": true
},
{
"name": "Remote/Hybrid Work Effectiveness",
"is_primary": false
}
],
"tags": [
{
"name": "Others",
"code": "OT01",
"is_primary": true
}
],
"company_mentions": [
{
"uuid": "00000l1",
"name": "Canva",
"website": "http://www.canva.com"
}
],
"article_type": "Explainer",
"is_press_release": true,
"is_opinion": true,
"is_breaking": false,
"iptc_codes": [
"20000362",
"20001206"
],
"iab_categories": [
"W3CW2J",
"130"
],
"naics_codes": [
"54151"
],
"sic_codes": [
"3570"
],
"entities": {
"person": [
"kredbylle timbang"
],
"location": [
"bataan",
"philippines"
],
"product": [
"canva offline",
"canva"
],
"event": []
},
"newsworthiness_score": 0.8162999749183655,
"group_id": null
}
]
}
```
## OpenAPI
````yaml GET /v1/news
openapi: 3.0.3
info:
title: Akta.pro API
description: >
Akta provides APIs for company intelligence and news monitoring:
1. **News** – Enriched news articles with AI summaries, sentiment, event
tags, industry classifications, and company mention resolution.
2. **Company Enrichment** – Structured company data including firmographics,
funding, headcount, and financials.
3. **Company Search** – Free endpoint to resolve company names, domains, or
UUIDs.
4. **Product Reviews** – G2 product reviews with ratings and review content.
5. **Employee Reviews** – Employee sentiment data with workplace ratings.
**Authentication:** All endpoints require an API key in the `x-api-key` HTTP
header.
version: 1.0.0
contact:
url: https://akta.pro
servers:
- url: https://api.akta.pro/api
description: Production server
security: []
tags:
- name: News
description: Enriched news articles with AI summaries, sentiment, and company mentions
- name: Company
description: Company data enrichment and search
- name: Reviews
description: Product and employee reviews from external sources
externalDocs:
description: Official Akta.pro API Documentation
url: https://docs.akta.pro
paths:
/v1/news:
get:
tags:
- News
summary: News
description: >
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.
operationId: getNews
parameters:
- name: company
in: query
required: false
schema:
type: string
description: >-
Website (e.g. 'https://canva.com') or company UUID returned by the
Company Search API.
- name: industry
in: query
required: false
schema:
type: string
description: >-
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.
- name: query
in: query
required: false
schema:
type: string
description: >-
Topic name to search articles. Allows open-ended topic name. Eg.
Crude oil price developments
- name: title
in: query
required: false
schema:
type: string
description: Searches articles based on the title entered.
- name: start_date
in: query
required: false
schema:
type: string
format: date
description: >-
Start of the date range, formatted as YYYY-MM-DD. Non-enterprise
plans are limited to a 6-month lookback.
- name: end_date
in: query
required: false
schema:
type: string
format: date
description: End of the date range, formatted as YYYY-MM-DD. Default = today.
- name: limit
in: query
required: false
schema:
type: integer
default: 10
maximum: 1000
description: Maximum number of news articles to return. Default = 10, Max = 1000.
- name: offset
in: query
required: false
schema:
type: integer
default: 0
description: >-
Number of results to skip before returning records. Use with limit
for pagination.
- name: group_articles
in: query
required: false
schema:
type: boolean
description: >-
Accepts boolean. True will group similar articles from the same
event.
- name: news_score_list
in: query
required: false
schema:
type: string
enum:
- High
- Medium
- Low
- all
description: >-
Filter by news score tier. Accepted values: High, Medium, Low, all.
Default = all
- name: countries
in: query
required: false
schema:
type: string
description: >-
Filters articles based on the country of the event. Comma separated
list of ISO country codes.
- name: blacklisted
in: query
required: false
schema:
type: string
description: Comma separated list of publisher domains to exclude.
- name: type_list
in: query
required: false
schema:
type: string
description: >-
Filter by news type. Download full list from
https://playground.akta.pro/news-tags.csv. Default = all.
- name: sentiment_list
in: query
required: false
schema:
type: string
description: >-
Comma-separated list of sentiments to filter by. Accepted values:
positive, negative, neutral, all. Default = all. Example:
sentiment_list=positive,negative
- name: entity_person_list
in: query
required: false
schema:
type: string
description: Comma separated list of people names.
- name: entity_location_list
in: query
required: false
schema:
type: string
description: Comma separated list of locations.
- name: entity_product_list
in: query
required: false
schema:
type: string
description: Comma separated list of product names.
- name: entity_event_list
in: query
required: false
schema:
type: string
description: Comma separated list of event names.
- name: naics_code_list
in: query
required: false
schema:
type: string
description: Comma separated list of NAICS codes.
- name: sic_code_list
in: query
required: false
schema:
type: string
description: Comma separated list of SIC codes.
- name: iptc_code_list
in: query
required: false
schema:
type: string
description: Comma separated list of IPTC codes.
- name: iab_code_list
in: query
required: false
schema:
type: string
description: Comma separated list of IAB codes.
responses:
'200':
description: News articles returned
content:
application/json:
schema:
type: object
properties:
status:
type: string
example: success
total:
type: integer
description: Total matching articles available.
count:
type: integer
description: Number of articles returned in the data array.
limit:
type: integer
offset:
type: integer
credits_consumed:
type: number
format: float
data:
type: array
items:
$ref: '#/components/schemas/NewsArticle'
'204':
description: No content — no articles matched the query.
'400':
description: Bad request — invalid parameters.
'401':
description: Unauthorized — missing or invalid API key.
security:
- xApiKeyAuth: []
components:
schemas:
NewsArticle:
type: object
properties:
title:
type: string
description: Headline of the article.
url:
type: string
format: uri
description: Canonical URL of the original article.
publisher:
type: string
description: Name of the publishing outlet.
published_date:
type: string
description: Publication date in YYYY-MM-DD format.
sentiment:
type: string
enum:
- positive
- negative
- neutral
description: Article-level sentiment.
news_score:
type: number
format: float
description: Relevance and quality score between 0.0 and 1.0.
ai_summary:
type: string
description: AI-generated summary of the article.
full_text:
type: string
description: Complete body text of the article.
original_language:
type: string
description: ISO 639-1 language code.
author:
type: string
description: Article author name.
countries:
type: array
items:
type: string
description: Array of ISO 3166-1 alpha-2 country codes.
industries:
type: array
items:
$ref: '#/components/schemas/Industry'
description: Industries associated with the article.
types:
type: array
items:
$ref: '#/components/schemas/Tag'
description: News types associated with the article.
company_mentions:
type: array
items:
$ref: '#/components/schemas/CompanyMention'
description: Companies mentioned in the article.
Industry:
type: object
properties:
name:
type: string
description: Industry name.
code:
type: string
description: Machine-readable industry code.
is_primary:
type: boolean
description: True if this is the primary industry classification.
Tag:
type: object
properties:
name:
type: string
description: Human-readable tag label.
code:
type: string
description: Machine-readable tag code.
is_primary:
type: boolean
description: True if this is the primary event tag.
CompanyMention:
type: object
properties:
company_id:
type: string
format: uuid
description: Akta UUID for the company.
name:
type: string
description: Company display name.
website:
type: string
format: uri
description: Company website URL.
is_primary:
type: boolean
description: True if this is the main company the article is about.
securitySchemes:
xApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: API key obtained from your Akta account.
````