URL Intel | Node.js SDK

The URL Intel service allows you to retrieve intelligence about known URLs, giving you insight into the reputation of a URL.

URL Intel

constructor(token: string, config: PangeaConfig): URLIntelService

Creates a new URLIntelService with the given Pangea API token and configuration.

required parameters

token

string

Pangea API token.

configPangeaConfig

Configuration.

Response Object

URLIntelService

const config = new PangeaConfig({ domain: "pangea_domain" });
const urlIntel = new URLIntelService("pangea_token", config);

post(endpoint: string, data: object, options: PostOptions): Promise<PangeaResponse<R>>

POST request.

required parameters

endpoint

string

Endpoint path.

data

object

Request body.

optionsPostOptions

Additional options.

Response Object

R

Promise<PangeaResponse<R>>

Reputation check

reputation(url: string, options: ReputationOptions): Promise<PangeaResponse<ReputationResult>>

Retrieve a reputation score for a URL from a provider, including an optional detailed report.

required parameters

url

string

The URL to be looked up

optionsReputationOptions

An object of optional parameters. Parameters supported:

• provider {String} - Use reputation data from this provider. Default provider defined by the configuration.
• verbose {Boolean} - Echo the API parameters in the response. Default: verbose=false.
• raw {Boolean} - Include raw data from this provider. Default: raw=false.

Response Object

ReputationResult

Promise<PangeaResponse<ReputationResult>>

const response = await urlIntel.reputation(
  "http://113.235.101.11:54384",
  {
    provider: "crowdstrike"
  }
);

Reputation check V2

reputationBulk(urls: string[], options: ReputationOptions): Promise<PangeaResponse<ReputationBulkResult>>

Retrieve reputation scores for URLs, from a provider, including an optional detailed report.

required parameters

urls

Array<string>

A list of URLs to be looked up

optionsReputationOptions

An object of optional parameters. Parameters supported:

• provider {String} - Use reputation data from this provider. Default provider defined by the configuration.
• verbose {Boolean} - Echo the API parameters in the response. Default: verbose=false.
• raw {Boolean} - Include raw data from this provider. Default: raw=false.

Response Object

ReputationBulkResult

Promise<PangeaResponse<ReputationBulkResult>>

const response = await urlIntel.reputationBulk(
  ["http://113.235.101.11:54384"],
  {
    provider: "crowdstrike"
  }
);