> ## Documentation Index
> Fetch the complete documentation index at: https://api.tryspecter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get company news

> Returns a company's complete news-signal history.

<Note> Costs 1 credit per request. </Note>

## What you need

A Specter company ID; get one from [Search company name](/api-reference/companies/search-company-name).

## Behaviour

- Sorted reverse-chronologically (most recent first).
- Page through with `page` and `limit`.
- Set `major_only=true` to return only major news (importance score of at least 4).
- Bound results by publication date with `news_publication_date_after` / `news_publication_date_before` (both inclusive).
- Returns `404` when the company is unknown to Specter, and `200` with an empty array when the company is known but has no signals.

## What you do next

- **Get the company profile.** Follow the `companyId` to [Get company by ID](/api-reference/companies/get-company-by-id).
- **Open a single signal.** Pass a `signal_id` to [Get News Signal by ID](/api-reference/news-signals/get-news-signal-by-id).




## OpenAPI

````yaml /api-ref/bundle_api.yaml get /companies/{companyId}/news-signals
openapi: 3.0.0
info:
  title: Specter API
  termsOfService: https://tryspecter.com/terms/
  contact:
    name: API support
    email: api-support@tryspecter.com
  version: 1.0.0
servers:
  - description: Production
    url: https://app.tryspecter.com/api/v1
security:
  - ApiKeyAuth: []
tags:
  - name: Enrich
    description: >
      Look up a company, person, or investor and, if Specter does not already
      hold it, fetch it on demand. Includes email-based person enrichment.
  - name: Search
    description: |
      Find records across every product from a single plain-English query.
  - name: Companies
    description: >
      Company profiles, funding, headcount, traction, the per-company signals
      and sub-resources attached to a single company, and identifier resolution.
  - name: People
    description: >
      Specter people records: profile data, contact details, and per-person
      lookups for a known person ID.
  - name: Investors
    description: >
      Specter investor records: profile, activity, targeting, funds, portfolio
      companies, and the funding rounds they have participated in.
  - name: Transactions
    description: |
      Transaction detail by ID: funding rounds, acquisitions, and IPOs.
  - name: News Signals
    description: |
      Company-level news signals: by ID, and for a saved list or company search.
  - name: Revenue Signals
    description: >
      Revenue and profitability signals: by ID, by date, and for a saved list or
      company search.
  - name: Talent Signals
    description: |
      Talent signals: by ID and in bulk by ID.
  - name: Investor Interest Signals
    description: |
      Investor interest signals: by ID and in bulk by ID.
  - name: Company Lists
    description: |
      Create, query, and maintain lists of companies, including their results.
  - name: Investor Lists
    description: |
      Create, query, and maintain lists of investors, including their results.
  - name: People Lists
    description: |
      Create, query, and maintain lists of people, including their results.
  - name: Saved Searches
    description: |
      List and delete searches saved via tryspecter.com.
  - name: Company Saved Searches
    description: |
      Details and results for saved company searches.
  - name: People Saved Searches
    description: |
      Details and results for saved people searches.
  - name: Investor Saved Searches
    description: |
      Details and results for saved investor searches.
  - name: Talent Signals Saved Searches
    description: |
      Details and results for saved Talent Signals searches.
  - name: Investor Interest Saved Searches
    description: |
      Details and results for saved Investor Interest Signals searches.
  - name: Network
    description: >
      Your team's LinkedIn network: the people and companies your teammates are
      connected to, and your reach into a given company.
  - name: Account
    description: >
      Organisation-level resources: your team's members, API call logs, and
      credit balance.
paths:
  /companies/{companyId}/news-signals:
    get:
      tags:
        - Companies
      summary: Get company news
      description: >
        Returns a company's complete news-signal history.


        <Note> Costs 1 credit per request. </Note>


        ## What you need


        A Specter company ID; get one from [Search company
        name](/api-reference/companies/search-company-name).


        ## Behaviour


        - Sorted reverse-chronologically (most recent first).

        - Page through with `page` and `limit`.

        - Set `major_only=true` to return only major news (importance score of
        at least 4).

        - Bound results by publication date with `news_publication_date_after` /
        `news_publication_date_before` (both inclusive).

        - Returns `404` when the company is unknown to Specter, and `200` with
        an empty array when the company is known but has no signals.


        ## What you do next


        - **Get the company profile.** Follow the `companyId` to [Get company by
        ID](/api-reference/companies/get-company-by-id).

        - **Open a single signal.** Pass a `signal_id` to [Get News Signal by
        ID](/api-reference/news-signals/get-news-signal-by-id).
      parameters:
        - $ref: '#/components/parameters/CompanyId'
        - $ref: '#/components/parameters/PaginationPage'
        - $ref: '#/components/parameters/PaginationLimit'
        - in: query
          name: major_only
          schema:
            type: boolean
            default: false
          required: false
          description: >
            When `true`, only return signals with importance score >= 4 ("major
            news only"). Mirrors the front-end toggle.
        - in: query
          name: news_publication_date_after
          required: false
          schema:
            type: string
            format: date
            example: '2026-06-01'
          description: >
            Only return signals with a publication date on or after this date
            (`YYYY-MM-DD`, inclusive).
        - in: query
          name: news_publication_date_before
          required: false
          schema:
            type: string
            format: date
            example: '2026-06-30'
          description: >
            Only return signals with a publication date on or before this date
            (`YYYY-MM-DD`, inclusive).
      responses:
        '200':
          $ref: '#/components/responses/NewsSignalsResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/OutOfCredits'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimits'
components:
  parameters:
    CompanyId:
      in: path
      name: companyId
      schema:
        type: string
      required: true
      description: The Specter company ID.
    PaginationPage:
      in: query
      name: page
      schema:
        type: number
      required: false
      description: The page number of results to return, base 0, default is 0.
    PaginationLimit:
      in: query
      name: limit
      schema:
        type: number
      required: false
      description: The number of results to return, default is 50.
  responses:
    NewsSignalsResponse:
      description: List of news signals matching the query.
      content:
        application/json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/NewsSignal'
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            oneOf:
              - $ref: '#/components/schemas/ApiKeyMissing'
              - $ref: '#/components/schemas/ApiKeyNotValid'
    OutOfCredits:
      description: Out of credits - API credit limit exceeded
      content:
        application/json:
          schema:
            type: object
            required:
              - errorCode
              - message
            properties:
              errorCode:
                type: string
                enum:
                  - OUT_OF_CREDITS
              message:
                type: string
                description: |
                  There are no more credits available to complete the request.
      headers:
        X-CreditLimit-Limit:
          schema:
            type: integer
          description: The total number of credits allocated for the current period
        X-CreditLimit-Remaining:
          schema:
            type: integer
          description: The number of credits remaining for the current period
        X-CreditLimit-Reset:
          schema:
            type: number
            format: float
          description: The number of seconds until the credit limit resets
    Forbidden:
      description: Forbidden - There is no permissions to use the endpoint
      content:
        application/json:
          schema:
            type: object
            properties:
              errorCode:
                description: NOT_PERMITTED
                type: string
                example: NOT_PERMITTED
              message:
                type: string
                description: You do not have permission to access this resource.
                example: You do not have permission to access this resource.
            required:
              - errorCode
              - message
    NotFound:
      description: Not Found
      content:
        application/json:
          schema:
            type: object
            required:
              - errorCode
              - message
            properties:
              errorCode:
                type: string
                description: NOT_FOUND
              message:
                type: string
                description: Not Found
    RateLimits:
      description: Too Many Requests - API Rate limit exceeded
      content:
        application/json:
          schema:
            type: object
            required:
              - errorCode
              - message
            properties:
              errorCode:
                type: string
                description: RATE_LIMITED
              message:
                type: string
                description: You have been rate-limited
      headers:
        X-RateLimit-Limit:
          schema:
            type: integer
          description: The total rate limit allowed for this endpoint
        X-RateLimit-Remaining:
          schema:
            type: integer
          description: The number of requests remaining
        X-RateLimit-Reset:
          schema:
            type: number
            format: float
          description: The number of seconds until the rate limit resets
  schemas:
    NewsSignal:
      title: NewsSignal
      type: object
      description: >
        A single classified company mention within a news article; if an article
        mentions multiple companies, each mention is recorded as a separate
        signal.
      additionalProperties: false
      required:
        - article_id
        - article_url
        - categories
        - company_domain
        - company_name
        - entity_id
        - featured_image_url
        - fetched_at
        - meaningful_updates
        - published_date
        - score
        - signal_id
        - title
        - title_original
        - traction
        - whats_new
      properties:
        signal_id:
          description: Unique identifier for this news signal.
          type: integer
          example: 538589
        article_id:
          description: >-
            Underlying article id. Articles that mention multiple companies
            share this id across signals.
          type: integer
          example: 914756
        article_url:
          description: The URL linking to the original source article.
          type: string
          example: >-
            https://www.linkedin.com/posts/petterblid_so-proud-to-share-our-q2-report-today-and-activity-7481238353364054018-obd_
        published_date:
          description: Date (YYYY-MM-DD) the article was published.
          type: string
          format: date
          example: '2026-07-10'
        fetched_at:
          description: Timestamp Specter fetched the article.
          type: string
          format: date-time
          example: '2026-07-10T09:19:40.270718Z'
        title:
          description: Article title in English (translated when needed).
          type: string
          example: >-
            So proud to share our Q2 report today and the results the team at
            Litium has delivered.
        title_original:
          description: Article title in the original publication language.
          type: string
          example: >-
            So proud to share our Q2 report today and the results the team at
            Litium has delivered.
        featured_image_url:
          description: URL to the article's featured image.
          type: string
          example: https://www.breakit.se/img/default.png
        categories:
          description: Categories the publication tagged this article with.
          type: array
          items:
            type: string
          example:
            - Revenue Update
            - Profitability Update
            - Growth
        entity_id:
          description: |
            Specter company id that the signal is attributed to.
          type: string
          example: 5e3bbea200c8f4c9669f6601
        company_name:
          description: Name of the company the signal is attributed to.
          type: string
          example: Litium
        company_domain:
          description: Primary domain of the company.
          type: string
          example: litium.com
        meaningful_updates:
          description: >
            Categories of newsworthy update detected on the article: revenue
            figures, profitability, traction milestones, funding rounds,
            acquisitions / deals.
          type: array
          items:
            type: string
            enum:
              - REVENUE_UPDATE
              - PROFIT_UPDATE
              - TRACTION_UPDATE
              - FUNDING_UPDATE
              - DEAL_UPDATE
          example:
            - REVENUE_UPDATE
            - PROFIT_UPDATE
        whats_new:
          description: >-
            A short AI-generated summary of what the article reports for this
            company.
          type: string
          example: >-
            Litium ARR SEK 100M (prev ~SEK 90M in 2025); returned to
            profitability, Cash EBITDA positive in June.
        score:
          description: Importance score (0-5). 4+ is considered "major news".
          type: integer
          example: 4
        traction:
          description: Free-text traction headline associated with the company, if any.
          type: string
          example: >-
            SEK 100M ARR, Net revenue increased 32%, ARR grew 19%, Returned to
            profitability, Cash EBITDA positive in June
    ApiKeyMissing:
      properties:
        errorCode:
          description: API_KEY_MISSING
          example: API_KEY_MISSING
          type: string
        message:
          description: No API Key was presented on the header X-API-KEY
          example: No API Key was presented on the header X-API-KEY
          type: string
    ApiKeyNotValid:
      properties:
        errorCode:
          description: API_KEY_NOT_VALID
          example: API_KEY_NOT_VALID
          type: string
        message:
          description: API key present, but not valid
          example: API key present, but not valid
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````