> ## 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

<ParamField header="x-api-key" type="string" required>
  Your API key.
</ParamField>

## URL Parameters

<ParamField query="company" type="string">
  Website (e.g. `https://canva.com`) or company UUID returned by the Company Search API.
</ParamField>

<ParamField query="industry" type="string">
  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.
</ParamField>

<ParamField query="query" type="string">
  Topic name to search articles. Allows open-ended topic name. Eg. Crude oil price developments
</ParamField>

<ParamField query="title" type="string">
  Searches articles based on the title entered.
</ParamField>

<ParamField query="start_date" type="string">
  Start of the date range, formatted as `YYYY-MM-DD`. Non-enterprise plans are limited to a 6-month lookback.
</ParamField>

<ParamField query="end_date" type="string">
  End of the date range, formatted as `YYYY-MM-DD`.

  Default = today
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of news articles to return.

  Default = 10

  Max value = 1000
</ParamField>

<ParamField query="offset" type="integer">
  Number of results to skip before returning records. Use with `limit` for pagination.

  Default = 0
</ParamField>

<ParamField query="group_articles" type="boolean">
  Accepts boolean. True will group similar articles from the same event.
</ParamField>

<ParamField query="news_score_list" type="string">
  Filter by news score tier. Accepted values: `High`, `Medium`, `Low` , `all`

  Default = `all`
</ParamField>

<ParamField query="countries" type="string">
  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.
</ParamField>

<ParamField query="blacklisted" type="string">
  Comma separated list of publisher domains to exclude.
</ParamField>

<ParamField query="type_list" type="string">
  Filter by news type. [View](/news-types)  full list of news categories.

  Default = `all`
</ParamField>

<ParamField query="sentiment_list" type="string">
  Filter by sentiment. Accepted values: `positive`, `negative`, `neutral`, `all`.

  Default = `all`
</ParamField>

<ParamField query="entity_person_list" type="string">
  Comma separated list of people names.
</ParamField>

<ParamField query="entity_location_list" type="string">
  Comma separated list of locations.
</ParamField>

<ParamField query="entity_product_list" type="string">
  Comma separated list of product names
</ParamField>

<ParamField query="entity_event_list" type="string">
  Comma separated list of event names
</ParamField>

<ParamField query="naics_code_list" type="string">
  Comma separated list of NAICS codes. [View](/naics-codes) full list of NAICS codes.
</ParamField>

<ParamField query="sic_code_list" type="string">
  Comma separated list of SIC codes. [View](/sic-codes)  full list of SIC codes.
</ParamField>

<ParamField query="iptc_code_list" type="string">
  Comma separated list of IPTC codes. [View](/iptc-codes) full list of IPTC codes.
</ParamField>

<ParamField query="iab_code_list" type="string">
  Comma separated list of IAB codes. [View](/iab-codes) full list of IAB codes.
</ParamField>

## Response

#### Successful Response Fields

Returns a JSON object with the following structure:

<ResponseField name="total" type="integer">
  Total number of articles available based on the filters set
</ResponseField>

<ResponseField name="limit" type="integer">
  Limit applied to the request.
</ResponseField>

<ResponseField name="offset" type="integer">
  Offset applied to the request.
</ResponseField>

<ResponseField name="credits_consumed" type="float">
  Number of credits consumed
</ResponseField>

<ResponseField name="count" type="integer">
  Number of articles returned in the data array.
</ResponseField>

<ResponseField name="data" type="array">
  List of news article objects.
</ResponseField>

<ResponseExample>
  ```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
      }
      ]
  }
  ```
</ResponseExample>