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 and CLIs via MCP.

Base URL

All API requests are made to the following base URL:

Base URL

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

Authentication

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

Bash

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:

JSON

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

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

Errors

Errors return a structured JSON object with actionable guidance:

JSON

{
  "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

HTTP Code	Type	Description
400	`validation_error`	Missing or invalid parameters
400	`prerequisite_error`	Must complete a prior step first (includes `required_step` and `docs_url`)
401	`authentication_error`	Missing, invalid, or revoked API key
403	`credit_error`	Insufficient credits for this operation
403	`limit_error`	Plan limit reached (e.g., competitor count)
404	`not_found_error`	Resource not found
429	`rate_limit_error`	Daily rate limit exceeded (includes `retry_after`)
500	`server_error`	Internal server error

Rate Limits

Plan	Requests / Day
Free	100
Pro	1,000
Ultra	5,000
Enterprise	10,000

Credits

Operation	Cost
Generate Battlecard	1 credit
AI Modify Battlecard	0.5 credits
Create Company	Free
Add Competitor	Free (plan limits apply)
Add Product	Free
List / Get (all read ops)	Free

SDKs

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

MCP Server

For AI agents (Claude, Cursor, Copilot):

Bash

npx signallabs-mcp

See the MCP Setup Guide for full configuration instructions.

What's Next?

Quickstart MCP Server Using the Dashboard