Introduction

Signal Labs is a real-time competitive intelligence platform. Track competitors, generate AI-powered battlecards, and monitor competitive and market signals from the dashboard, or programmatically via REST API, native SDKs, or AI tools, agents, and CLIs via MCP.

Base URL

All API requests are made to the following base URL:

https://app.usesignallabs.com/api/v1

Authentication

All API requests require a Bearer token in the Authorization header:

curl https://app.usesignallabs.com/api/v1/companies \
  -H "Authorization: Bearer sl_live_your_key_here"

Get your API key from Settings > API Keys.

Response Format

All responses return JSON with a consistent structure:

{
  "data": { ... },
  "meta": {
    "total": 5
  }
}

List endpoints return data as an array. Single-resource endpoints return data as an object.

Endpoints

Document endpoints are listed separately under Documents. A machine-readable OpenAPI description of everything below is available at /v1/openapi.json.

Asynchronous Operations

Creating a company and adding a competitor both return before their work is finished. Researching a website takes 30–90 seconds, so the API records the row, responds, and continues in the background rather than holding the connection open.

This means a company you just created has no offerings yet, and a competitor you just added has no researched page yet. Poll until the status field reports completion:

# profile_status is "pending" while the website is being analysed,
# then "ready". generation_status behaves the same way for competitors.
curl https://app.usesignallabs.com/api/v1/companies/{company_id}/profile \
  -H "Authorization: Bearer sl_live_your_key_here"

Errors

Errors return a structured JSON object with actionable guidance:

{
  "error": {
    "code": "insufficient_credits",
    "message": "Battlecard generation requires 1 credit. Your organization has 0 remaining.",
    "type": "credit_error",
    "credits_remaining": 0,
    "credits_required": 1,
    "upgrade_url": "https://app.usesignallabs.com/settings/billing"
  }
}

Error Types

Rate Limits

Storage Quotas

Credits

Documents

Upload competitive documents for AI analysis and RAG-powered battlecard generation.

Documents are automatically parsed, chunked, and embedded for RAG. Use document_ids when generating battlecards to include uploaded documents as additional context.

After processing, each document is also auto-tagged in the background: an AI pass identifies which of your tracked competitors it discusses, so the document surfaces on those competitors and in chat retrieval without you filing it manually. The upload response returns auto_tagging: "pending"; read the resulting auto_tags from either GET endpoint a few seconds later.

Enablement Focus Types

When generating battlecards, specify one of these focus types:

SDKs

• JavaScript / TypeScript: npm install @signal-labs/sdk
• Python: pip install signallabs

MCP Server

For AI agents (Claude, Cursor, Copilot):

npx signallabs-mcp

See the MCP Setup Guide for full configuration instructions.

What's Next?