Skip to main content

Domain Intel | Node.js SDK

The Domain Intel service allows you to retrieve intelligence about known domain names, giving you insight into the reputation of a domain.

Domain Intel

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

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

required parameters

string

Pangea API token.

Configuration.

Response Object

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

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

POST request.

required parameters

string

Endpoint path.

object

Request body.

Additional options.

Response Object

Promise<PangeaResponse<R>>

Reputation check

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

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

required parameters

string

The domain to be looked up.

An object of optional parameters. Parameters supported:

  • provider {String} - Use reputation data from these providers: "crowdstrike" or "domaintools". 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

Promise<PangeaResponse<ReputationResult>>
const response = await domainIntel.reputation(
  "google.com"
);

Bulk reputation check

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

Retrieve reputations for a list of domains, from a provider, including an optional detailed report.

required parameters

Array<string>

The domain list to be looked up.

An object of optional parameters. Parameters supported:

  • provider {String} - Use reputation data from these providers: "crowdstrike" or "domaintools". 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

Promise<PangeaResponse<ReputationBulkResult>>
const response = await domainIntel.reputationBulk(
  ["google.com"]
);

WhoIs

whoIs(domain: string, options: WhoIsOptions): Promise<PangeaResponse<WhoIsResult>>

Retrieve who is for a domain from a provider, including an optional detailed report.

required parameters

string

The domain to query.

An object of optional parameters. Parameters supported:

  • provider {String} - Use reputation data from this provider: "whoisxml". 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

Promise<PangeaResponse<WhoIsResult>>
const response = await domainIntel.whoIs(
  "google.com",
  {
    verbose: true,
    raw: true,
  }
);