> ## Documentation Index
> Fetch the complete documentation index at: https://api.tryspecter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Interest Signals

> Detected investor attention — which investors are looking at which companies and founders, and how strongly.

Detect investor attention before deals are announced. Interest Signals show which investors are engaging with companies or founders — often weeks before a funding round or acquisition becomes public. Each signal captures who is interested, how strong the interest is, and what they're looking at.

## Data categories

* **Investor activity** — which investors are showing interest (`signal_investors`, returned as names).
* **Signal strength** — a confidence score (`signal_score`, 1–10) based on engagement patterns.
* **Target** — the company or person the interest is focused on (`signal_type` is Company or Talent).
* **Context** — a plain-English `signal_summary`, plus funding context at signal time (`signal_total_funding_usd`, `signal_last_funding_date`) and `signal_date`.
* **Source type** — where the signal was observed (`source_types`: insider, venture\_capital, angel, journalist, influencer, investment\_bank, private\_equity, investor).

```json Example (trimmed) theme={null}
{
  "signal_id": "02d32673-f1ab-40a1-93c5-a3a36a10d342",
  "signal_date": "2025-12-01",
  "signal_type": "Company",
  "signal_score": 9,
  "signal_summary": "Porcupine VC are in talks with Hedgehog Analytics as it seeks seed capital.",
  "source_types": "insider",
  "entity_id": "5e3a7f2b0aa7a3270a55f2a8",
  "signal_investors": [{ "name": "Bluebirds Capital" }]
}
```

## Endpoints

| Method | Endpoint                                                                                                                                                 | Returns                                    |
| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| `GET`  | [Get Investor Interest Signal by ID](/api-reference/talent-and-interest-signals/get-investor-interest-signal-by-id)                                      | The matching interest signal(s)            |
| `POST` | [Bulk get Investor Interest Signals by ID](/api-reference/talent-and-interest-signals/bulk-get-investor-interest-signals-by-id)                          | Up to 50 signals in one request            |
| `GET`  | [Get Investor Interest Signals saved search details](/api-reference/investor-interest-saved-searches/get-investor-interest-signals-saved-search-details) | A saved search's name, query ID, and count |
| `GET`  | [Get Investor Interest Signals saved search results](/api-reference/investor-interest-saved-searches/get-investor-interest-signals-saved-search-results) | Signals matching a saved search            |

## How to use the API

**Monitor a feed (most common)**

Create an Interest Signals search in the Specter app and share it with the API, then poll [Get Investor Interest Signals saved search results](/api-reference/investor-interest-saved-searches/get-investor-interest-signals-saved-search-results) with `new=true` to pull just that week's new signals. Discover the `searchId` with [Get all saved searches](/api-reference/saved-searches/get-all-saved-searches).

**Look up specific signals**

Interest signal IDs come from other records — a company's `specter_strategic_signal_ids`, a person's `investor_signal_ids`, or an investor's `strategic_signal_ids`. One → [Get Investor Interest Signal by ID](/api-reference/talent-and-interest-signals/get-investor-interest-signal-by-id); many → [Bulk get Investor Interest Signals by ID](/api-reference/talent-and-interest-signals/bulk-get-investor-interest-signals-by-id).

**Expand from a signal**

* `entity_id` → [Get company by ID](/api-reference/companies/get-company-by-id) (Company signals) or [Get person info by ID](/api-reference/people/get-person-info-by-id) (Talent signals). When `entity_id` is absent, use the embedded company domain or person `linkedin_url`.
* `signal_investors[].name` → resolve to a Specter record via [Look up investors](/api-reference/investors/look-up-investors) or [Search investor name](/api-reference/investors/search-investor-name) (the signal carries investor names, not IDs).

## Good to know

* Signals use UUIDs.
* `signal_score` is a 1–10 confidence score.
* `signal_type` is Company or Talent — the target can be a company or a person.
* `entity_id` is the company ID (Company signals) or person ID (Talent signals); it may be absent, in which case use the embedded company domain or person `linkedin_url`.
* Investors are returned as names (`signal_investors[].name`), not IDs — resolve them via investor lookup.
* Saved searches must be shared with the API to be reachable; empty results are valid, not an error.
* [Get Investor Interest Signal by ID](/api-reference/talent-and-interest-signals/get-investor-interest-signal-by-id) costs 1 credit per request.