What Is a Signal?
A signal is a detected event that indicates buying intent or a relevant business change at a target company. Puffle monitors dozens of data sources continuously and surfaces signals that match your configured signal types. Examples:- A company in your ICP posted a VP of Engineering role on LinkedIn (Hiring signal)
- A prospect’s company announced a Series B funding round (Funding signal)
- A target company’s CEO published a post about scaling their sales team (LinkedIn Post signal)
Signal Types
Signal types define what Puffle monitors. There are two kinds:Built-in Types
Pre-configured by Puffle — Hiring, Funding, LinkedIn Posts, Reddit Mentions, News, SEC Filings. Always present on your account. You can tune their keywords, scoring criteria, and enabled state, but not rename or delete them.
Custom Types
Fully user-defined. You specify keywords, search instructions, scoring criteria, and which data sources to monitor. Up to 20 signal types total (built-in + custom).
Data Sources
Puffle monitors the following sources:| Source | Identifier | Description |
|---|---|---|
| LinkedIn Jobs | linkedin_jobs | Job postings on LinkedIn |
| LinkedIn Posts | linkedin_posts | Public posts from company pages and individuals |
reddit | Posts and comments matching keywords | |
| News | news | News articles from web crawls |
| Hacker News | hacker_news | HN posts and comments |
| X / Twitter | x_twitter | Public tweets |
| SEC Filings | sec_filings | SEC EDGAR filings (10-K, 10-Q, 8-K, etc.) |
| G2 Reviews | g2 | G2 product reviews mentioning competitors |
Signal Lifecycle
detected_at (newest first by default). Once dismissed, signals are removed from the active feed but remain accessible via the API with include_dismissed=true.
API Endpoints
| Endpoint | Description |
|---|---|
| GET /signals/types | List and manage signal type configurations |
| GET /signals | Read your signal feed |
| POST /signals/:id/dismiss | Dismiss a signal |
| POST /signals/:id/feedback | Submit signal quality feedback |