> ## Documentation Index
> Fetch the complete documentation index at: https://agent-docs.akta.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# News Detail API

> Fetches the complete enriched article record — AI summary, full text, sentiment, industry tags, named entities, and company mentions — for one or more specific news article IDs.

## Overview

The News Detail API returns the full enriched record for one or more news articles, identified by `news_ids`. It returns the same article structure as the [News Signals API](/api-reference/news-signals), scoped to exact IDs rather than a search query — useful when you already know which articles you need, typically because you found them via the News Signals API and now want their complete data, including full text. Results are returned in the API response.

## Endpoint Details

* **Method:** GET
* **Endpoint:** `/api/v1/news/by-id/`

## 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="news_ids" type="string" required>
  Comma-separated list of news article IDs (e.g. `34144849, 34186756`). IDs are obtained from the `id` field returned by the News Signals API.
</ParamField>

#### Example Request

```text theme={null}
GET /v1/news/by-id?news_ids=34144849%2C%2034186756
x-api-key: <your_api_key>
```

## Response

#### Successful Response Fields

Returns a JSON object with the following structure:

<ResponseField name="count" type="integer">
  Number of articles returned.
</ResponseField>

<ResponseField name="data" type="array">
  Array of enriched article objects, one per requested news ID that was found.
</ResponseField>

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

<ResponseExample>
  ```json 200 expandable wrap theme={null}
  {
      "count": 2,
      "data": [
          {
              "id": 34186756,
              "title": "Canva Hits 100 Visual Suite Updates: What Matters for Teams",
              "url": "https://www.techrepublic.com/article/news-canva-visual-suite-100-updates/",
              "publisher": "TechRepublic",
              "published_date": "2026-09-08T17:25:02",
              "sentiment": "Positive",
              "sentiment_score": 1,
              "ai_summary": "Canva released more than 100 updates to its Visual Suite in 2026, aiming to reduce workflow friction by integrating capabilities across Docs, Sheets, Whiteboards, and presentations. The upgrades include AI-driven data analysis in Sheets, improved collaboration features in Whiteboards, and layout enhancements in Docs, allowing teams to move content between applications without manual exporting. While adoption metrics show significant growth in enterprise usage and monthly active users, the company notes that these changes largely streamline existing workflows rather than introducing entirely new functionalities.",
              "word_count": 624,
              "original_language": "EN",
              "author": "Techrepublic Staff",
              "countries": [],
              "industries": [
                  {
                      "name": "Document Creation & Office Suites",
                      "code": "BPAMAMAD",
                      "is_primary": true
                  },
                  {
                      "name": "Whiteboarding & Visual Collaboration",
                      "code": "BPAMAMAI",
                      "is_primary": false
                  },
                  {
                      "name": "Augmented Analytics & AI-Assisted BI (NLQ/NLG, Insights)",
                      "code": "HDAEAMAD",
                      "is_primary": false
                  }
              ],
              "tags": [
                  {
                      "name": "Product Launches & Enhancements",
                      "code": "SD01",
                      "is_primary": true
                  }
              ],
              "company_mentions": [
                  {
                      "uuid": "00000l1",
                      "name": "Canva",
                      "website": "http://www.canva.com",
                      "is_primary": true
                  },
                  {
                      "uuid": "00000r9",
                      "name": "Google",
                      "website": "https://www.google.com",
                      "is_primary": false
                  },
                  {
                      "uuid": "005fi2w",
                      "name": "blah",
                      "website": "https://teams.com",
                      "is_primary": false
                  }
              ],
              "article_type": {
                  "code": "explainer",
                  "label": "Explainer"
              },
              "is_press_release": true,
              "is_opinion": false,
              "is_breaking": true,
              "iptc_codes": [
                  {
                      "code": "20000231",
                      "name": "software and applications"
                  },
                  {
                      "code": "20001298",
                      "name": "artificial intelligence"
                  },
                  {
                      "code": "20000192",
                      "name": "business strategy and marketing"
                  }
              ],
              "iab_categories": [
                  {
                      "code": "W3CW2J",
                      "name": "Technology & Computing"
                  },
                  {
                      "code": "612",
                      "name": "Technology & Computing"
                  }
              ],
              "naics_codes": [
                  {
                      "code": "5132",
                      "name": "Information"
                  },
                  {
                      "code": "51321",
                      "name": "Information"
                  },
                  {
                      "code": "513210",
                      "name": "Information"
                  }
              ],
              "sic_codes": [
                  {
                      "code": "7372",
                      "name": "SERVICES-PREPACKAGED SOFTWARE"
                  }
              ],
              "entities": {
                  "person": [
                      "cameron adams"
                  ],
                  "location": [],
                  "product": [
                      "canva",
                      "google pics",
                      "google workspace"
                  ],
                  "event": []
              },
              "newsworthiness_score": 0.8632,
              "group_id": 10586771,
              "full_text": "Canva has shipped more than 100 Visual Suite upgrades in 2026 as it expands Docs, Sheets, Whiteboards, presentations, and other workplace tools. Image: Generated by ChatGPT. Canva has shipped 100-plus Visual Suite upgrades in 2026. Here are the changes most likely to reduce tool-switching, rework, and workflow friction. Written By Sep 8, 2026 We may earn from vendors via affiliate links or sponsorships. This might affect product placement on our site, but not the content of our reviews. See our Terms of Use for details. Loading Audio Player By Instaread, Please Wait... Canva marked its 100th Visual Suite upgrade of 2026 on Sept. 3 after rolling out new capabilities across Docs, Presentations, Sheets, Whiteboards, Websites, and Video. The pace works out to nearly one upgrade every other day, according to Canva co-founder and chief product officer Cameron Adams. For marketing, communications, and reporting teams already using Canva, the most useful changes are the ones that reduce exporting, rebuilding, and switching between separate tools. Canva says the upgrades address more than 55,000 user-submitted wishes, ideas, and suggestions. More than 100 million people use Canva Presentations every month, Docs usage has more than tripled over the past three years, and Canva says its enterprise business has doubled in the last year. Docs gained end-to-end banners, drag-and-drop visuals, and other layout improvements, while Presentations picked up one-click presenting and auto-generated presenter notes. These changes reduce setup time but largely improve workflows that were already available in Canva. Sheets gained AI tools that can analyze data and turn it into charts and tables. Canva says that output can then move into presentations and Docs without manual exporting and reuploading. Google Workspace is adding similar AI-powered data analysis, but Canva combines the analysis and presentation stages inside the same Visual Suite project. Whiteboards gained Follow Collaborators, one-click reactions, and easier movement from brainstorming into finished work. Teams can also turn a Whiteboard into a Doc instead of rebuilding workshop notes before circulating them. Microsoft is also expanding collaboration features in Teams, while Canva is tying Whiteboards more directly to the documents and presentations teams create afterward. Canva Websites gained custom navigation for up to 20 sections, SEO titles, and domain controls. Canva says users now publish close to one million new websites a month. The additions can cover lightweight campaign or project sites without requiring another site builder, although Canva does not replace a full content management system. Video is included in the 100-plus upgrade count, but Canva's milestone announcement does not identify a comparably specific new Video workflow. Advertisement Teams using the new AI features should test generated charts against known reporting data and check how much manual cleanup remains when content moves from Sheets into Docs or presentations. What IT should verify before wider rollout Canva's adoption figures describe scale rather than how deeply companies rely on the platform. More than 100 million monthly Presentation users and a doubled enterprise business do not reveal seat depth or how much work runs through centrally governed deployments. Canva's Enterprise documentation lists SSO, SCIM provisioning, role-based access controls, audit logs, data residency options, and Canva Shield controls for AI access. IT and procurement teams should still confirm plan-specific AI limits, regional requirements, contract terms, and what business data employees intend to route into AI-assisted features. Guidance on data that should stay out of AI chatbots can provide a baseline for deciding what should remain outside general-purpose AI workflows. The most consequential updates are the ones that let teams carry the same work from Whiteboards to Docs, Sheets, presentations, and lightweight websites with less exporting and rebuilding between each stage. Also read: Google Pics is rolling out to eligible Workspace customers with built-in AI image tools and administrator controls. TechRepublic Staff"
          },
          {
              "id": 34144849,
              "title": "American Film Institute Reveals 2026-2027 Canva Fellowship Recipients",
              "url": "https://variety.com/2026/artisans/news/afi-canva-fellowship-recipients-2026-1236852125/",
              "publisher": "Variety",
              "published_date": "2026-09-08T17:00:00",
              "sentiment": "Positive",
              "sentiment_score": 0.9975,
              "ai_summary": "The American Film Institute announced the 2026-27 Canva Fellowship recipients at its Conservatory: Divli Bhat, Elizaveta Kurilova, Lauren Moreno, Zoey Punteney, Colin Pham, and Auberin Strickland. Each fellow receives a $40,000 scholarship for their two-year Master of Fine Arts program.",
              "word_count": 546,
              "original_language": "EN",
              "author": "Isabelle Farina",
              "countries": [
                  "USA"
              ],
              "industries": [
                  {
                      "name": "Film, Television & Media Arts Colleges",
                      "code": "EDAHAJAE",
                      "is_primary": true
                  },
                  {
                      "name": "Scholarship, Financial Aid & FAFSA Support",
                      "code": "EDAMAKAF",
                      "is_primary": false
                  }
              ],
              "tags": [
                  {
                      "name": "Others",
                      "code": "OT01",
                      "is_primary": true
                  }
              ],
              "company_mentions": [
                  {
                      "uuid": "00000l1",
                      "name": "Canva",
                      "website": "http://www.canva.com",
                      "is_primary": true
                  },
                  {
                      "uuid": "000apll",
                      "name": "American Film Institute",
                      "website": "http://www.afi.com/",
                      "is_primary": true
                  }
              ],
              "article_type": {
                  "code": "promotional",
                  "label": "Promotional"
              },
              "is_press_release": true,
              "is_opinion": false,
              "is_breaking": false,
              "iptc_codes": [
                  {
                      "code": "20000002",
                      "name": "arts and entertainment"
                  },
                  {
                      "code": "20000403",
                      "name": "adult and continuing education"
                  }
              ],
              "iab_categories": [
                  {
                      "code": "92",
                      "name": "Business and Finance"
                  }
              ],
              "naics_codes": [
                  {
                      "code": "611610",
                      "name": "Educational Services"
                  },
                  {
                      "code": "61161",
                      "name": "Educational Services"
                  }
              ],
              "sic_codes": [
                  {
                      "code": "8200",
                      "name": "SERVICES-EDUCATIONAL SERVICES"
                  }
              ],
              "entities": {
                  "person": [
                      "lauren moreno",
                      "divli bhat",
                      "elizaveta kurilova",
                      "zoey punteney",
                      "colin pham",
                      "auberin strickland",
                      "rachel friedman",
                      "eyal levy",
                      "vickie curtis",
                      "grant lafferty",
                      "hunter nolan",
                      "gina papabeis",
                      "dmitry vasyukov",
                      "susan ruskin",
                      "herner werzog",
                      "dune strickland"
                  ],
                  "location": [
                      "alaska",
                      "mexican american"
                  ],
                  "product": [
                      "palmdale",
                      "sheep and ants and sugar",
                      "margie and mannequin",
                      "come swim with me",
                      "bucking fastard"
                  ],
                  "event": [
                      "latino film festival"
                  ]
              },
              "newsworthiness_score": 0.925,
              "group_id": 10560593,
              "full_text": "The American Film Institute (AFI) has announced the recipients of the 2026-27 Canva Fellowship at the AFI Conservatory. The six recipients are: Divli Bhat for producing, Elizaveta Kurilova for screenwriting, Lauren Moreno for directing, Zoey Punteney for production design, Colin Pham for cinematography and Auberin Strickland for editing. The fellows began their Master of Fine Arts filmmaking program at the AFI Conservatory in August. Over the course of their two-year program, each fellow will receive a $40,000 scholarship. Related Stories 'Bucking Fastard' Review: Herner Werzog's Uddled-Mup Fairytale Stars the Mara Sisters as You've Never Seen Her Before \"At the AFI Conservatory, we are empowering Fellows to take the helm of creative departments across the entire filmmaking life cycle,\" dean of the AFI Conservatory Susan Ruskin said. \"Now in its fourth year, our partnership with Canva prepares Fellows to lead — amplifying their voices and sharing diverse perspectives with audiences worldwide, in pursuit of telling great stories.\" Popular on Variety 1/1 Continue watching after the ad Visit Advertiser website GO TO PAGE Meet the fellowship recipients below. Divli Bhat — Producing As a film production student at San Jose State University, Bhat has gotten a taste of what it takes to be a film producer. She has worked as a unit production manager, production coordinator, line producer and first assistant director on award-winning short films such as \"Margie and Mannequin.\" Along with her production skills, she is also a trained special effects makeup artist. Elizaveta Kurilova — Screenwriting Kurilova is a Los Angeles-based writer and director with a Bachelor of Arts in the history of art from University College London. While there, she received the Frances Stracey Prize and completed the One-Year Conservatory in Acting at the Lee Strasberg Theatre & Film Institute. She has written and directed several short films, including \"Come Swim With Me\" and \"Sheep and Ants and Sugar.\" Lauren Moreno — Directing Moreno is a third-generation Mexican American filmmaker who aims to bring her Latino identity to the forefront of her films, while expanding representation and sharing authentic stories. Her debut film \"Palmdale\" earned multiple awards and festival selections, following her first written film which screened at the Official Latino Film Festival. Colin Pham — Cinematography Pham studied radio-television-film at the University of Texas Austin, but his real experience came from hands-on work in various projects. He has worked as a director of photography, assistant camera and G & E professional, who grounds his cinematography in camera mechanics and storytelling. He has contributed to award-winning shorts and larger projects. Zoey Punteney — Production Design Punteney's minor in studio art from Johnny Carson Center for Emerging Media Arts gave her the opportunity to hone in on her creativity in a tangible way. She is also a content creator with a Youtube channel of 10,000 subscribers, which is where she realized her love for video editing. She hopes to work on major feature films in the future. Auberin Strickland — Editing Originally from Alaska, Strickland knows three languages — French, German and Italian — and prioritizes telling diverse stories in filmmaking. He runs Crooked Footprint Productions with his brother, Dune Strickland. He has previously worked with many filmmakers such as Dmitry Vasyukov, Hunter Nolan, Gina Papabeis, Vickie Curtis, Eyal Levy, Rachel Friedman and Grant Lafferty."
          }
      ],
      "credits_consumed": 0.12
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /v1/news/by-id/
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, search, and addition
  - name: Reviews
    description: Product and employee reviews from external sources
  - name: Supporting APIs
    description: Utility endpoints for request tracking
  - name: List Generation
    description: >-
      Build targeted company lists using structured filters or natural language
      queries
externalDocs:
  description: Official Akta.pro API Documentation
  url: https://docs.akta.pro
paths:
  /v1/news/by-id/:
    get:
      tags:
        - News
      summary: News Details
      description: >
        Fetches the complete enriched article record — AI summary, full text,
        sentiment, industry tags, named entities, company mentions, and
        classification codes (IPTC, IAB, NAICS, SIC) — for one or more specific
        news article IDs. Use this when you already know which articles you need
        (typically obtained via the News API) and want their full data,
        including the complete article text.
      operationId: getNewsById
      parameters:
        - name: news_ids
          in: query
          required: true
          schema:
            type: string
          description: >-
            Comma-separated list of news article IDs (e.g. '34144849,
            34186756'). IDs are obtained from the `id` field returned by the
            News API.
      responses:
        '200':
          description: News articles returned
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                    description: Number of articles returned in the data array.
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/NewsArticleDetail'
                  credits_consumed:
                    type: number
                    format: float
        '204':
          description: No content — no articles matched the supplied IDs.
        '400':
          description: Bad request — invalid or missing news_ids parameter.
        '401':
          description: Unauthorized — missing or invalid API key.
      security:
        - xApiKeyAuth: []
components:
  schemas:
    NewsArticleDetail:
      type: object
      properties:
        id:
          type: integer
          description: Akta article ID.
        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.
        sentiment_score:
          type: number
          format: float
          description: Numeric sentiment score between 0 and 1.
        ai_summary:
          type: string
          description: AI-generated summary of the article.
        word_count:
          type: integer
          description: Word count of the article body.
        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.
        tags:
          type: array
          items:
            $ref: '#/components/schemas/Tag'
          description: News tags associated with the article.
        company_mentions:
          type: array
          items:
            $ref: '#/components/schemas/CompanyMention'
          description: Companies mentioned in the article.
        article_type:
          type: object
          properties:
            code:
              type: string
            label:
              type: string
          description: Article type classification.
        is_press_release:
          type: boolean
          description: True if the article is a press release.
        is_opinion:
          type: boolean
          description: True if the article is an opinion piece.
        is_breaking:
          type: boolean
          description: True if the article is breaking news.
        iptc_codes:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
              name:
                type: string
          description: IPTC classification codes.
        iab_categories:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
              name:
                type: string
          description: IAB category codes.
        naics_codes:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
              name:
                type: string
          description: NAICS classification codes.
        sic_codes:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
              name:
                type: string
          description: SIC classification codes.
        entities:
          type: object
          properties:
            person:
              type: array
              items:
                type: string
            location:
              type: array
              items:
                type: string
            product:
              type: array
              items:
                type: string
            event:
              type: array
              items:
                type: string
          description: Named entities extracted from the article.
        newsworthiness_score:
          type: number
          format: float
          description: Relevance and quality score between 0 and 1.
        group_id:
          type: integer
          description: Group ID for clustered articles covering the same event.
        full_text:
          type: string
          description: Complete body text of 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.

````