Signals Summaries

Signals Summaries

Generate AI-powered summaries that consolidate insights from multiple signals into structured, actionable data points.

Use cases:

• Create company profiles from multiple research signals

• Generate qualification scorecards

• Build comprehensive intelligence reports

• Track changes over time

How it works:

1. Create multiple signals for a domain

2. Wait for signals to complete (or use batch with generateSummaryOnComplete: true)

3. Request a summary via POST /v1/companies/signals/summaries

4. Retrieve the summary with structured data points and qualifications

Each data point includes:

• Description of the insight

• Reference questions used

• Qualification score (disqualified → excellent)

• Supporting sources with URLs and snippets

Summaries can be automatically generated when batch signals complete, making it easy to research multiple companies in parallel.

Get all signal summaries for a domain

get

Retrieve all summaries that have been generated for a given domain with pagination support. Returns summaries ordered by creation date (latest first).

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

Query parameters

domainstringRequired

Filter summaries by company domain (e.g., "acme.com")

Example: acme.comPattern: ^[a-zA-Z0-9]([a-zA-Z0-9\-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9\-]{0,61}[a-zA-Z0-9])?)*$

limitinteger · min: 1 · max: 100Optional

Maximum number of results per page

Default: 20Example: 20

offsetintegerOptional

Number of results to skip for pagination

Default: 0Example: 0

Responses

200

Summaries retrieved successfully

application/json

400

Bad Request - Invalid parameters

application/json

401

Unauthorized - Invalid or missing API key

application/json

500

Internal Server Error

application/json

get

/v1/companies/signals/summaries

HTTPcURLJavaScriptPython

GET /v1/companies/signals/summaries?domain=text HTTP/1.1
Host: api.saber.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "results": [
    {
      "id": "58f74458-7e71-4ab6-8297-55dab9c752c0",
      "summary": [
        {
          "description": "Company operates in the Enterprise Software industry",
          "referenceQuestions": [
            "What industry does this company operate in?"
          ],
          "qualification": "good",
          "sources": [
            {
              "url": "https://acme.com/about",
              "title": "About Acme Corp",
              "snippet": "Leading provider of enterprise software..."
            }
          ]
        }
      ],
      "status": "completed",
      "signalsCount": 10,
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:32:00Z"
    },
    {
      "id": "7e53d8a2-6a4b-4c66-aea3-40d29462e433",
      "summary": [
        {
          "description": "Company operates in the Enterprise Software industry",
          "referenceQuestions": [
            "What industry does this company operate in?"
          ],
          "qualification": "good",
          "sources": [
            {
              "url": "https://acme.com/about",
              "title": "About Acme Corp"
            }
          ]
        }
      ],
      "status": "completed",
      "signalsCount": 9,
      "createdAt": "2024-01-15T09:00:00Z",
      "updatedAt": "2024-01-15T09:02:00Z"
    }
  ],
  "total": 2,
  "limit": 20,
  "offset": 0,
  "count": 2
}

Generate a signal summary

post

Generate an AI-powered summary of all completed signals for a given domain. The summary consolidates key insights from multiple signals into structured data points.

If there are no completed signals for the domain, returns 204 No Content. If a summary is already in progress for this domain, returns 409 Conflict. If there are no new signals since the last summary, returns the latest existing summary.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

Body

application/json

domainstring · min: 1 · max: 253Required

The company domain to generate a summary for (e.g., "acme.com")

Example: acme.comPattern: ^[a-zA-Z0-9]([a-zA-Z0-9\-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9\-]{0,61}[a-zA-Z0-9])?)*$

Responses

200

Summary generated successfully

application/json

204

No Content - No completed signals available for summary

400

Bad Request - Invalid input

application/json

401

Unauthorized - Invalid or missing API key

application/json

409

Conflict - A summary is already in progress for this domain

application/json

500

Internal Server Error

application/json

post

/v1/companies/signals/summaries

HTTPcURLJavaScriptPython

POST /v1/companies/signals/summaries HTTP/1.1
Host: api.saber.app
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "domain": "acme.com"
}

{
  "summary": [
    {
      "description": "Company operates in the Enterprise Software industry",
      "referenceQuestions": [
        "What industry does this company operate in?"
      ],
      "qualification": "good",
      "sources": [
        {
          "url": "https://acme.com/about",
          "title": "About Acme Corp",
          "snippet": "Leading provider of enterprise software..."
        }
      ]
    },
    {
      "description": "Company uses AWS for cloud infrastructure",
      "referenceQuestions": [
        "What cloud providers does this company use?"
      ],
      "qualification": "good",
      "sources": [
        {
          "url": "https://acme.com/technology",
          "title": "Technology Stack",
          "snippet": "Built on AWS cloud infrastructure..."
        }
      ]
    }
  ]
}