APITube Help Center

How to Monitor Cybersecurity Threats with a News API

Find incident reports and follow affected vendors

Tasha Tatum

Written by Tasha Tatum

July 3, 2026

Updated October 16, 2026

Open this example in the API Playground ↗

How to monitor cybersecurity threats

Search /v1/news/everything for incident terms such as ransomware or data breach. Add a company, topic or date filter to narrow the coverage. For ongoing alerts, use the same conditions in an SSE stream or dashboard webhook.

curl "https://api.apitube.io/v1/news/everything?title=ransomware&language.code=en&published_at.start=NOW-7DAY" \
  -H "X-API-Key: YOUR_API_KEY"

The example searches English headlines about ransomware from the last week. Send the key through X-API-Key or api_key.

How do you catch threats by keyword?

title searches headlines and accepts 2–100 characters. Multiple unquoted words must all match:

# Both words must appear in the title
curl "https://api.apitube.io/v1/news/everything?title=data%20breach&published_at.start=NOW-1WEEK" \
  -H "X-API-Key: YOUR_API_KEY"

Quote a phrase to require its order. A positive ~N suffix relaxes the match to the words without fixed order; it does not enforce a maximum word gap:

# Exact phrase, then a looser "supply chain … attack" match
curl 'https://api.apitube.io/v1/news/everything?title="zero-day"' -H "X-API-Key: YOUR_API_KEY"
curl 'https://api.apitube.io/v1/news/everything?title="supply chain attack"~2' -H "X-API-Key: YOUR_API_KEY"

Use ignore.title for unwanted headline terms. Headline searches have a 31-day date-window limit.

How do you follow one vendor or product’s incidents?

Use organization.name or a numeric entity.id for a company, or brand.name for a recognized product or brand:

curl "https://api.apitube.io/v1/news/everything?organization.name=Microsoft&sentiment.overall.polarity=negative" \
  -H "X-API-Key: YOUR_API_KEY"

sentiment.overall.polarity=negative selects negative article tone. To inspect tone toward the vendor, use entity.sentiment.polarity=negative with the entity filter. Entity scores run from -1 to 1 and support minimum and maximum bounds.

If a name is not found, look up its ID. See entity searches.

How do you scope to a security topic or category?

Look up a relevant topic or category before using its ID:

curl "https://api.apitube.io/v1/suggest/topics?prefix=cyber" -H "X-API-Key: YOUR_API_KEY"
curl "https://api.apitube.io/v1/suggest/categories?prefix=technology" -H "X-API-Key: YOUR_API_KEY"

Copy the returned ID into topic.id or category.id. Each accepts up to three values with OR. Unknown identifiers can return 400; see topic filters.

How do you keep only urgent, breaking incidents?

Combine is_breaking=1 with a date window:

curl "https://api.apitube.io/v1/news/everything?title=cyberattack&is_breaking=1&published_at.start=NOW-1DAY&per_page=250" \
  -H "X-API-Key: YOUR_API_KEY"

The flag accepts 0 or 1 and is separate from publication time. The maximum page size is 250 on Professional and Corporate, 200 on Basic, 50 on Starter or 10 on Free. Free allows five pages. Select compact alert fields with fl=id,title,source.domain,published_at.

How do you get threat alerts in real time?

Open an SSE connection with your filters:

curl -N "https://api.apitube.io/v1/news/stream?title=ransomware&is_breaking=1" \
  -H "X-API-Key: YOUR_API_KEY"

SSE checks new matches about every 30 seconds, sends heartbeats and supports Last-Event-Id on reconnect. Each delivered article uses one streaming credit.

Alternatively, create a dashboard webhook to send signed HTTP requests to your app. See webhook setup, breaking-news filters and the parameter reference.

Common Questions

Is there a dedicated cybersecurity endpoint?

No. Use the regular news endpoint with filters for the incidents, vendors and subjects you follow.

How do I track one vendor’s breaches specifically?

Combine its company or entity filter with incident terms. Add entity sentiment if you want a negative-tone view. Sentiment alone does not identify a breach.

Why does title=data breach miss the exact phrase?

It requires both words but allows different positions. Use title="data breach" for an exact phrase. A positive suffix such as ~2 relaxes the word order rather than enforcing a maximum gap.

How do I get alerted the moment a breach is reported?

Use SSE or a webhook for new matching articles. It reports available news coverage, with your plan’s data delay, rather than detecting the breach itself.


Related Articles