Search Pulses
search_pulsesSearch OTX threat-intel pulses by KEYWORD, campaign, malware family or actor name, e.g. "ransomware" or "APT29". Returns pulse ID, name, description preview, tags, targeted countries, malware families, attack IDs, and indicator count. This matches pulse titles and descriptions, so a bare indicator value (an IP, domain, hash or CVE id) will find nothing here, use lookup_indicator for those.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "ransomware"
},
"name": "search_pulses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page (default 1) | |
| limit | No | 1-50 (default 20) | |
| query | Yes | Search term |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | Total number of pulses matching the query | |
| pulses | Yes | List of pulse summaries | |
| returned | Yes | Number of pulses returned in this response |