Signals API — competitive intelligence and monitoring

The Signals API powers ManticScore’s competitive intelligence layer. You add companies to a watchlist, configure web monitors that crawl their sites on a schedule, and the platform surfaces AI-enriched signals — funding announcements, product launches, hiring trends, and pricing changes — ranked by relevance. The score endpoint gives you a single number that reflects how actively your environment is being monitored.

List signals

Returns signals across all monitored companies. Filter by company or signal type using query parameters.

number

default:"50"

Maximum signals to return. Upper bound: 200.

number

default:"0"

Number of signals to skip for pagination.

string

UUID of a specific company. Omit to return signals for all monitored companies.

string

Filter by signal type string (e.g. funding, product_launch, hiring).

curl "https://api.manticscore.com/signals?limit=50&company_id=9f4e2a1b-..." \
  -H "Authorization: Bearer <token>"

import httpx

resp = httpx.get(
    "https://api.manticscore.com/signals",
    headers={"Authorization": "Bearer <token>"},
    params={"limit": 50, "company_id": "9f4e2a1b-..."},
)
print(resp.json())

200 response

{
  "signals": [
    {
      "id": "a1b2c3d4-...",
      "company_id": "9f4e2a1b-...",
      "signal_type": "funding",
      "title": "Series B announced",
      "summary": "Acme Corp raises $40M Series B led by Sequoia.",
      "ai_insight": "Signals aggressive expansion into enterprise segment.",
      "relevance_score": 0.85,
      "signal_tag": "threat",
      "source_url": "https://techcrunch.com/...",
      "cluster_id": null,
      "detected_at": "2026-04-18T09:00:00Z",
      "created_at": "2026-04-18T09:05:00Z",
      "company_name": "Acme Corp",
      "company_domain": "acmecorp.com",
      "company_logo_url": "https://logo.clearbit.com/acmecorp.com"
    }
  ],
  "total": 42
}

object[]

required

Show signal properties

string

UUID of the signal.

string

UUID of the company that generated the signal.

string

Machine-readable signal category (e.g. funding, hiring, product_launch).

string

Short headline for the signal.

string

One-paragraph summary of the source content.

string

ManticScore’s strategic interpretation of what this signal means for your product.

number

AI-assigned relevance score between 0 and 1.

string

High-level classification: threat, opportunity, or neutral.

string

URL of the original source page.

string

Groups related signals together. null if this signal stands alone.

string

ISO 8601 timestamp when the signal was first detected.

string

Display name of the monitored company.

string

Domain of the monitored company, or null if unknown.

string

Logo URL sourced from Clearbit, or null if unavailable.

number

required

Total number of signals matching the query (before pagination).

Companies

List companies

Returns all companies in your watchlist with their full enriched profiles.

curl "https://api.manticscore.com/signals/companies" \
  -H "Authorization: Bearer <token>"

200 response

{
  "companies": [
    {
      "id": "9f4e2a1b-...",
      "name": "Acme Corp",
      "domain": "acmecorp.com",
      "relationship": "watchlist",
      "sector": "fintech",
      "description": "B2B expense management platform."
    }
  ]
}

Discover companies

Search for companies to add to your watchlist. Powered by Exa’s web search index.

string

required

Search query. Between 2 and 200 characters.

number

default:"10"

Maximum results to return. Upper bound: 20.

curl "https://api.manticscore.com/signals/companies/discover?q=fintech+expense&limit=10" \
  -H "Authorization: Bearer <token>"

200 response

{
  "companies": [
    {
      "name": "Expensify",
      "domain": "expensify.com",
      "description": "Expense management and receipt scanning platform.",
      "already_added": false
    }
  ],
  "query": "fintech expense"
}

Returns 503 if the Exa search integration is not configured on this deployment.

Add a company

Creates a company entry and enqueues Exa enrichment. If you supply a domain, a web monitor is created automatically.

string

required

Display name for the company.

string

Company domain (e.g. acmecorp.com). Providing a domain triggers enrichment and auto-creates a web monitor.

string

default:"watchlist"

How this company relates to your work. Currently only watchlist is supported.

string

Industry sector label (e.g. fintech, devtools).

string

Free-text description of the company.

curl -X POST https://api.manticscore.com/signals/companies \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Acme Corp", "domain": "acmecorp.com", "relationship": "watchlist", "sector": "fintech"}'

import httpx

resp = httpx.post(
    "https://api.manticscore.com/signals/companies",
    headers={"Authorization": "Bearer <token>"},
    json={"name": "Acme Corp", "domain": "acmecorp.com", "sector": "fintech"},
)
print(resp.json())

200 response

{
  "company": {
    "id": "9f4e2a1b-...",
    "name": "Acme Corp",
    "domain": "acmecorp.com",
    "relationship": "watchlist",
    "sector": "fintech"
  }
}

Get a company

Returns the full company profile plus a 30-day signal summary.

curl "https://api.manticscore.com/signals/companies/9f4e2a1b-..." \
  -H "Authorization: Bearer <token>"

200 response

{
  "id": "9f4e2a1b-...",
  "name": "Acme Corp",
  "domain": "acmecorp.com",
  "sector": "fintech",
  "signal_summary": {
    "total_30d": 10,
    "threats": 3,
    "opportunities": 5,
    "recent_7d": 4
  }
}

object

Show properties

number

Total signals detected in the last 30 days.

number

Signals tagged as threats.

number

Signals tagged as opportunities.

number

Signals detected in the last 7 days.

Update a company

Accepts any subset of fields. Changing the domain triggers re-enrichment and creates a new monitor automatically.

string

Updated display name.

string

New domain. Changing this re-enriches the company and auto-creates a monitor.

string

Relationship type.

string

Industry sector.

string

Updated description.

curl -X PATCH "https://api.manticscore.com/signals/companies/9f4e2a1b-..." \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"sector": "payments"}'

Returns the full updated company row on 200.

Enrich a company

Queues an Exa enrichment job to refresh the company’s profile data.

curl -X POST "https://api.manticscore.com/signals/companies/9f4e2a1b-.../enrich" \
  -H "Authorization: Bearer <token>"

200 response

{"queued": true, "company_id": "9f4e2a1b-..."}

Delete a company

curl -X DELETE "https://api.manticscore.com/signals/companies/9f4e2a1b-..." \
  -H "Authorization: Bearer <token>"

200 response

{"deleted": true}

List signals for a company

number

default:"50"

Maximum signals to return. Upper bound: 200.

string

Filter to a specific signal type.

curl "https://api.manticscore.com/signals/companies/9f4e2a1b-.../signals?limit=50" \
  -H "Authorization: Bearer <token>"

200 response

{
  "signals": [],
  "total": 0,
  "company_id": "9f4e2a1b-..."
}

Get company highlights

Returns a summarized view of recent signal activity, agent metrics, and the last crawl timestamp — useful for rendering a company card.

curl "https://api.manticscore.com/signals/companies/9f4e2a1b-.../highlights" \
  -H "Authorization: Bearer <token>"

200 response

{
  "company_id": "9f4e2a1b-...",
  "company_name": "Acme Corp",
  "agent_metrics": {},
  "signal_summary": {"total_30d": 10, "threats": 3, "opportunities": 5, "recent_7d": 4},
  "last_crawled_at": "2026-04-18T06:00:00Z"
}

Get company snapshots

Returns point-in-time data snapshots captured during past enrichment runs.

number

default:"20"

Maximum snapshots to return. Upper bound: 100.

curl "https://api.manticscore.com/signals/companies/9f4e2a1b-.../snapshots?limit=20" \
  -H "Authorization: Bearer <token>"

200 response

{
  "snapshots": [
    {
      "id": "c4d5e6f7-...",
      "data": {},
      "created_at": "2026-04-18T06:00:00Z"
    }
  ]
}

Monitors

Monitors define which URLs to crawl and how often. When you add a company with a domain, ManticScore creates a monitor automatically. Use these endpoints to view and control your monitors directly.

List monitors

curl "https://api.manticscore.com/signals/monitors" \
  -H "Authorization: Bearer <token>"

200 response

{
  "monitors": [
    {
      "id": "d1e2f3a4-...",
      "company_id": "9f4e2a1b-...",
      "crawl_frequency": "daily",
      "is_active": true,
      "last_crawl_at": "2026-04-18T06:00:00Z",
      "last_crawl_status": "success",
      "crawl_count": 12,
      "created_at": "2026-04-10T10:00:00Z"
    }
  ]
}

object[]

Show monitor properties

string

Monitor UUID.

string

UUID of the company being monitored.

string

daily or weekly.

boolean

Whether the monitor is currently scheduled.

string

ISO 8601 timestamp of the most recent crawl, or null if it has never run.

number

Total number of crawls completed.

Create a monitor

string

required

UUID of the company to monitor.

string[]

required

List of URLs to crawl during each run (e.g. homepage, blog, pricing page).

string

default:"daily"

How often to run the crawl. Either daily or weekly.

curl -X POST https://api.manticscore.com/signals/monitors \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"company_id": "9f4e2a1b-...", "crawl_urls": ["https://acmecorp.com", "https://acmecorp.com/blog"], "crawl_frequency": "daily"}'

201 response

{
  "monitor": {
    "id": "d1e2f3a4-...",
    "company_id": "9f4e2a1b-...",
    "crawl_frequency": "daily",
    "is_active": true,
    "crawl_count": 0
  }
}

Trigger an immediate crawl

Runs a crawl right now, outside the regular schedule. The job is enqueued asynchronously.

curl -X POST "https://api.manticscore.com/signals/monitors/d1e2f3a4-.../run" \
  -H "Authorization: Bearer <token>"

200 response

{"queued": true, "monitor_id": "d1e2f3a4-..."}

Competitive score

Returns a single score that summarizes how active your competitive monitoring is.

curl "https://api.manticscore.com/signals/score" \
  -H "Authorization: Bearer <token>"

200 response

{
  "score": 75,
  "status": "active",
  "signal_count": 42,
  "recent_count": 12
}

number

required

Competitive position score from 0 to 100.

string

required

gathering while monitors are still building signal history; active once you have sufficient coverage.

number

required

Total signals collected across all monitored companies.

number

required

Signals detected in the last 7 days.

Overview

Projects & Research

Build & Forge

Intelligence & Chat

Integrations & Ship

Pipeline & Realtime

Billing & Admin

Signals API — competitive intelligence and monitoring

List signals

Companies

List companies

Discover companies

Add a company

Get a company

Update a company

Enrich a company

Delete a company

List signals for a company

Get company highlights

Get company snapshots

Monitors

List monitors

Create a monitor

Trigger an immediate crawl

Competitive score

​List signals

​Companies

​List companies

​Discover companies

​Add a company

​Get a company

​Update a company

​Enrich a company

​Delete a company

​List signals for a company

​Get company highlights

​Get company snapshots

​Monitors

​List monitors

​Create a monitor

​Trigger an immediate crawl

​Competitive score

List signals

Companies

List companies

Discover companies

Add a company

Get a company

Update a company

Enrich a company

Delete a company

List signals for a company

Get company highlights

Get company snapshots

Monitors

List monitors

Create a monitor

Trigger an immediate crawl

Competitive score