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/v1Authentication
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.
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
| 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) |
| 400 | invalid_file | File type not supported or exceeds 25MB |
| 400 | document_context_too_large | Combined document text exceeds 100,000 character limit |
| 400 | document_not_ready | Document not found or not yet processed |
| 403 | storage_quota_exceeded | Organization storage quota exceeded |
| 500 | server_error | Internal server error |
Rate Limits
| Plan | Requests / Day |
|---|---|
| Free Trial | 100 |
| Starter | 500 |
| Pro | 1,000 |
| Ultra | 5,000 |
| Enterprise | 10,000 |
Storage Quotas
| Plan | Storage Quota |
|---|---|
| Free Trial | 100 MB |
| Starter | 1 GB |
| Pro | 5 GB |
| Ultra | 10 GB |
| Enterprise | 10 GB |
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 |
Documents
Upload competitive documents for AI analysis and RAG-powered battlecard generation.
| Method | Path | Description |
|---|---|---|
| POST | /v1/documents/upload | Upload a document (multipart form data, max 25MB). Supported: PDF, DOCX, XLSX, CSV, PPTX, TXT, MD, PNG, JPG, WebP. |
| GET | /v1/documents?company_id={id} | List documents with storage usage stats |
| GET | /v1/documents/{id} | Get document detail including extracted text |
| DELETE | /v1/documents/{id} | Delete a document and its RAG chunks |
Documents are automatically parsed, chunked, and embedded for RAG. Use document_ids when generating battlecards to include uploaded documents as additional context.
Enablement Focus Types
When generating battlecards, specify one of these focus types:
| Focus | Description | Parameter |
|---|---|---|
gtm_sales | GTM / Sales enablement (default) | competitor_id |
product | Product & engineering | competitor_id |
marketing_growth | Marketing & growth | competitor_id |
leadership | Strategy & leadership | competitor_id |
landscape | Multi-competitor landscape analysis | competitor_ids (array of 2+) |
Note: The landscape focus requires competitor_ids (an array of 2 or more competitor IDs) instead of competitor_id.
SDKs
- JavaScript / TypeScript:
npm install @signal-labs/sdk - Python:
pip install signallabs
MCP Server
For AI agents (Claude, Cursor, Copilot):
npx signallabs-mcpSee the MCP Setup Guide for full configuration instructions.