Skip to main content

Dataminr Pulse

App Vendor: Dataminr

App Category: Analytics & SIEM, Data Enrichment & Threat Intelligence

Connector Version: 1.0.1

API Version: v2 / v3 REST API

About App

The Dataminr Pulse app is a security integration that enables you to ingest real-time event intelligence from the Dataminr platform. It helps you enhance situational awareness and support monitoring and response workflows.

The Dataminr Pulse app is configured with Cyware Orchestrate to perform the following actions:

Action Name

Description

Get Alert by ID 

This action retrieves detailed information for a single alert.

Get Alerts 

This action retrieves real-time alerts for configured lists.

Get Lists 

This action retrieves all lists configured on the authenticated account, grouped by type.

Generic Action

This is a generic action used to make requests to any Dataminr Pulse endpoint.

Configuration Parameters

The following configuration parameters are required for the Dataminr Pulse app to communicate with the Dataminr Pulse enterprise application. The parameters can be configured by creating instances in the app.

Parameter

Description

Field Type

Required/Optional

Comments

Client ID

Enter the client ID to authenticate with the dataminr API.

Text

Required

Client Secret

Enter the client secret to authenticate with the Dataminr API.

Password

Required

Verify

Choose your preference to verify SSL or TLS while making requests. It is recommended to set this option to yes. Passing no may result in connection errors.

Boolean

Optional

Allowed values:

true and false

By default, verification is enabled.

Timeout

Enter the timeout value in seconds. This is the number of seconds that requests will wait to establish a connection with Dataminr Pulse.

Integer

Optional

Allowed range:

15-120

Default timeout value:

15

Action: Get Alert by ID

This action retrieves detailed information for a single alert.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Alert ID

Enter the unique identifier of the alert to retrieve specific event data.

Example:

902569363-1751915862085-3

Text

Required

You can retrieve this ID using the Get Alerts action.

List IDs

Enter the comma-separated list of IDs to retrieve match reasons and list-specific details for the alert.

Text

Optional

Example Request

[
  {
    "alert_id": "5620169456974994531090-1771569469000-1",
    "list_ids": "4937512"
  }
]

Action: Get Alerts

This action retrieves real-time alerts for configured lists.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

List IDs

Enter the comma-separated list of IDs to retrieve alerts for specific lists. If not provided, alerts from all configured lists are retrieved.

Text

Optional

Page Size

Enter the maximum number of alerts to retrieve on each page.

Integer

Optional

Allowed range:

1-100

Default value:

40

Example Request

[
  {
    "list_ids": "4937512",
    "page_size": "10"
  }
]

Action: Get Lists

This action retrieves all lists configured on the authenticated account, grouped by type.

Action Input Parameters

No input parameters are required for this action.

Action: Generic Action

This is a generic action used to make requests to any Dataminr Pulse endpoint.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Method

Enter the HTTP method to make the request.

Text

Required

Allowed values are GET, PUT, POST, and DELETE.

Endpoint

Enter the endpoint to make the request

Example:

system/lookups

Text

Required

Query Params

Enter the query parameters to pass to the API.

Key Value

Optional

Payload

Enter the payload to pass to the API.

Any

Optional

Extra Fields

Enter the extra fields to pass to the API.

Key Value

Optional

Allowed keys:

headers, payload_data, custom_output, download, filename, files, retry_wait, retry_count, and response_type.

Example Request

[
  {
    "method": "GET",
    "endpoint": "pulse/v1/alerts?lists=4937512&from=H4sIAAAAAAAA%2F1XQXStDcRwH8HPW%2Bh5HkiRJkiRJSEuSJIQkSZIkyWprrdamOS%2FA0RJZKKzIc0IjseSCMxfjwlNLiIyLHUkr5eLY%2F7doiVs3nxfw0elLJaPFYjbV2sxOaaC43%2BiUrJLVYTeb%2BlYnCdXuE0KptkIo3FyNoUrbJrR65wjNnguGrJArhqYRNyHX%2FcCQHR%2BOIZMeGUriywz1wesoOjbPCAbfHqEsNK2K%2BsNBQv5ahKH75ZKhyMMYGrVPVUT8ktB5cM7Qsn4URc%2B%2BSig4mFKE5KDsF9LHZwhdrhBDhveJIef1XRUTfG9HQurPVlhM%2FFYUIeXl3C8kve0w9GpDhLroBKHiKqKKuucxhvbjYULNupfQdrqoipwnQMi7m2WoDPgI5bu3ipDGGf5V2B32BpNVcjitRlvS9NfoPc%2BFBldkHmHtT93H1IbMJ4ZjCzKv%2F7lZlPkEjguypfkJyy8cu%2BUQVAEAAA%3D%3D&pageSize=10",
    "extra_fields": {},
    "query_params": {}
  }
]