tools/integrations/firehose.md
Real-time web data streaming API that monitors web pages and delivers matching content instantly via server-sent events (SSE). Built for competitive intelligence, brand monitoring, and news tracking without polling.
| Integration | Available | Notes |
|---|---|---|
| API | ✓ | RESTful endpoints for managing rules + SSE for streaming |
| MCP | - | Not available |
| CLI | - | Not available |
| SDK | - | Native AI agent skill available |
Rules — Filters that define what content to match. Uses Lucene query syntax.
Stream — A server-sent event (SSE) connection that delivers matching content in real-time as it's published on the web.
Instead of polling an endpoint on a schedule, you define rules once and receive a continuous stream of matches as they happen.
# Exact phrase
"your brand name"
# Field-specific
title:tesla
domain:reuters.com
domain:techcrunch.com
# Boolean operators
"Series A" AND (SaaS OR software)
competitor OR "competitor name" NOT "your company"
# Wildcard
market* AND funding
# Language filter
language:en
# Date range
publish_time:[2026-01-01 TO 2026-03-18]
# ML-classified categories
category:finance
category:technology
POST https://api.firehose.com/rules
{
"query": "\"your brand name\" OR \"your product name\"",
"label": "brand-mentions"
}
GET https://api.firehose.com/rules
DELETE https://api.firehose.com/rules/{rule_id}
GET https://api.firehose.com/stream
Authorization: Bearer {api_key}
# Returns server-sent events:
# data: {"url": "...", "title": "...", "publish_time": "...", "matched_rule": "..."}
import EventSource from 'eventsource';
const stream = new EventSource('https://api.firehose.com/stream', {
headers: { Authorization: `Bearer ${process.env.FIREHOSE_API_KEY}` }
});
stream.onmessage = (event) => {
const item = JSON.parse(event.data);
console.log(`[${item.matched_rule}] ${item.title} — ${item.url}`);
};
Monitor competitors' press coverage, product announcements, and funding news in real-time.
query: "CompetitorName" AND (launch OR funding OR "product update" OR partnership)
Track mentions of your brand across news and web content.
query: "YourBrand" OR "YourProductName" NOT site:yourdomain.com
Stay current on your market without manually checking sources.
query: category:technology AND ("no-code" OR "low-code") AND funding
domain:techcrunch.com OR domain:venturebeat.com
Track signals that indicate a prospect is ready to buy (hiring, funding, tool mentions).
query: ("hiring" OR "we're growing") AND "RevOps" AND (HubSpot OR Salesforce)
Get alerted when publications cover topics in your space, enabling timely outreach.
query: "best [category] tools" OR "top [category] software" AND publish_time:[now-7d TO now]