Skip to main content

Domain Intel | Golang SDK

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

Reputation check

func (e *domainIntel) Reputation(ctx context.Context, input *DomainReputationRequest) (*pangea.PangeaResponse[DomainReputationResult], error)

Lookup an internet domain to retrieve reputation data.

required parameters

context.Context
input := &domain_intel.DomainReputationRequest{
	Domain: "737updatesboeing.com",
	Raw: true,
	Verbose: true,
	Provider: "domaintools",
}

checkResponse, err := domainintel.Reputation(ctx, input)

Reputation check V2

func (e *domainIntel) ReputationBulk(ctx context.Context, input *DomainReputationBulkRequest) (*pangea.PangeaResponse[DomainReputationBulkResult], error)

Lookup an internet domain list to retrieve reputation data.

required parameters

context.Context
domains := [...]string{"737updatesboeing.com"}

input := &domain_intel.DomainReputationBulkRequest{
	Domains: domains,
	Raw: true,
	Verbose: true,
	Provider: "domaintools",
}

checkResponse, err := domainintel.ReputationBulk(ctx, input)

WhoIs

func (e *domainIntel) WhoIs(ctx context.Context, input *DomainWhoIsRequest) (*pangea.PangeaResponse[DomainWhoIsResult], error)

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

required parameters

context.Context
input := &domain_intel.DomainWhoIsRequest{
	Domain: "google.com",
	Raw: true,
	Verbose: true,
	Provider: "whoisxml",
}

checkResponse, err := domainintel.WhoIs(ctx, input)

Type Client

type Client interface

required parameters

func(ctx context.Context, req *DomainReputationRequest) (*pangea.PangeaResponse[DomainReputationResult], error)
context.Context
func(ctx context.Context, req *DomainReputationBulkRequest) (*pangea.PangeaResponse[DomainReputationBulkResult], error)
context.Context
func(ctx context.Context, req *DomainWhoIsRequest) (*pangea.PangeaResponse[DomainWhoIsResult], error)
context.Context
pangea.BaseServicer

Base service methods

type Client interface {
	Reputation(ctx context.Context, req *DomainReputationRequest) (*pangea.PangeaResponse[DomainReputationResult], error)
	ReputationBulk(ctx context.Context, req *DomainReputationBulkRequest) (*pangea.PangeaResponse[DomainReputationBulkResult], error)
	WhoIs(ctx context.Context, req *DomainWhoIsRequest) (*pangea.PangeaResponse[DomainWhoIsResult], error)

	// Base service methods
	pangea.BaseServicer
}

Type DomainReputationBulkRequest

type DomainReputationBulkRequest struct

required parameters

pangea.BaseRequest

Base request has ConfigID for multi-config projects

[]string `json:"domains"`

The domain list to be looked up.

*bool `json:"verbose,omitempty"`

Echo the API parameters in the response.

*bool `json:"raw,omitempty"`

Include raw data from this provider.

string `json:"provider,omitempty"`

Use reputation data from this provider.

type DomainReputationBulkRequest struct {
	// Base request has ConfigID for multi-config projects
	pangea.BaseRequest

	// The domain list to be looked up.
	Domains	[]string	`json:"domains"`

	// Echo the API parameters in the response.
	Verbose	*bool	`json:"verbose,omitempty"`

	// Include raw data from this provider.
	Raw	*bool	`json:"raw,omitempty"`

	// Use reputation data from this provider.
	Provider	string	`json:"provider,omitempty"`
}

Type DomainReputationBulkResult

type DomainReputationBulkResult struct

required parameters

map[string]ReputationData `json:"data"`

High-level normalized results sent by the Pangea service

map[string]any `json:"parameters,omitempty"`

The parameters, which were passed in the request, echoed back

map[string]any `json:"raw_data,omitempty"`

The raw data from the provider. Each provider's data will have its own format

type DomainReputationBulkResult struct {
	// High-level normalized results sent
	// by the Pangea service
	Data	map[string]ReputationData	`json:"data"`

	// The parameters, which were passed in
	// the request, echoed back
	Parameters	map[string]any	`json:"parameters,omitempty"`

	// The raw data from the provider.
	// Each provider's data will have its own format
	RawData	map[string]any	`json:"raw_data,omitempty"`
}

Type DomainReputationRequest

type DomainReputationRequest struct

required parameters

pangea.BaseRequest

Base request has ConfigID for multi-config projects

string `json:"domain"`

The domain to be looked up.

*bool `json:"verbose,omitempty"`

Echo the API parameters in the response.

*bool `json:"raw,omitempty"`

Include raw data from this provider.

string `json:"provider,omitempty"`

Use reputation data from this provider.

type DomainReputationRequest struct {
	// Base request has ConfigID for multi-config projects
	pangea.BaseRequest

	// The domain to be looked up.
	Domain	string	`json:"domain"`

	// Echo the API parameters in the response.
	Verbose	*bool	`json:"verbose,omitempty"`

	// Include raw data from this provider.
	Raw	*bool	`json:"raw,omitempty"`

	// Use reputation data from this provider.
	Provider	string	`json:"provider,omitempty"`
}

Type DomainReputationResult

type DomainReputationResult struct

required parameters

ReputationData `json:"data"`

High-level normalized results sent by the Pangea service

interface{} `json:"parameters,omitempty"`

The parameters, which were passed in the request, echoed back

interface{} `json:"raw_data,omitempty"`

The raw data from the provider. Each provider's data will have its own format

type DomainReputationResult struct {
	// High-level normalized results sent
	// by the Pangea service
	Data	ReputationData	`json:"data"`

	// The parameters, which were passed in
	// the request, echoed back
	Parameters	interface{}	`json:"parameters,omitempty"`

	// The raw data from the provider.
	// Each provider's data will have its own format
	RawData	interface{}	`json:"raw_data,omitempty"`
}

Type DomainWhoIsRequest

type DomainWhoIsRequest struct

required parameters

pangea.BaseRequest

Base request has ConfigID for multi-config projects

string `json:"domain"`

The domain to query.

*bool `json:"verbose,omitempty"`

Echo the API parameters in the response.

*bool `json:"raw,omitempty"`

Include raw data from this provider.

string `json:"provider,omitempty"`

Use whois data from this provider.

type DomainWhoIsRequest struct {
	// Base request has ConfigID for multi-config projects
	pangea.BaseRequest

	// The domain to query.
	Domain	string	`json:"domain"`

	// Echo the API parameters in the response.
	Verbose	*bool	`json:"verbose,omitempty"`

	// Include raw data from this provider.
	Raw	*bool	`json:"raw,omitempty"`

	// Use whois data from this provider.
	Provider	string	`json:"provider,omitempty"`
}

Type DomainWhoIsResult

type DomainWhoIsResult struct

required parameters

WhoIsData `json:"data"`
map[string]any `json:"parameters,omitempty"`

The parameters, which were passed in the request, echoed back

map[string]any `json:"raw_data,omitempty"`

The raw data from the provider. Each provider's data will have its own format

type DomainWhoIsResult struct {
	Data	WhoIsData	`json:"data"`

	// The parameters, which were passed in
	// the request, echoed back
	Parameters	map[string]any	`json:"parameters,omitempty"`

	// The raw data from the provider.
	// Each provider's data will have its own format
	RawData	map[string]any	`json:"raw_data,omitempty"`
}

Type ReputationData

type ReputationData struct

required parameters

[]string `json:"category"`

The categories that apply to this indicator as determined by the provider

int `json:"score"`

The score, given by the Pangea service, for the indicator

string `json:"verdict"`

The verdict, given by the Pangea service, for the indicator

type ReputationData struct {
	// The categories that apply to this
	// indicator as determined by the provider
	Category	[]string	`json:"category"`

	// The score, given by the Pangea service,
	// for the indicator
	Score	int	`json:"score"`

	// The verdict, given by the Pangea service,
	// for the indicator
	Verdict	string	`json:"verdict"`
}

Type WhoIsData

type WhoIsData struct

required parameters

string `json:"domain_name"`
string `json:"domain_availability"`
string `json:"created_date,omitempty"`
string `json:"updated_date,omitempty"`
string `json:"expires_date,omitempty"`
[]string `json:"host_names,omitempty"`
[]string `json:"ips,omitempty"`
string `json:"registrar_name,omitempty"`
string `json:"contact_email,omitempty"`
*int `json:"estimated_domain_age,omitempty"`
string `json:"registrant_organization,omitempty"`
string `json:"registrant_country,omitempty"`
type WhoIsData struct {
	DomainName		string		`json:"domain_name"`
	DomainAvailability	string		`json:"domain_availability"`
	CreatedDate		string		`json:"created_date,omitempty"`
	UpdatedDate		string		`json:"updated_date,omitempty"`
	ExpiresDate		string		`json:"expires_date,omitempty"`
	HostNames		[]string	`json:"host_names,omitempty"`
	IPs			[]string	`json:"ips,omitempty"`
	RegistrarName		string		`json:"registrar_name,omitempty"`
	ContactEmail		string		`json:"contact_email,omitempty"`
	EstimatedDomainAge	*int		`json:"estimated_domain_age,omitempty"`
	RegistrantOrganization	string		`json:"registrant_organization,omitempty"`
	RegistrantCountry	string		`json:"registrant_country,omitempty"`
}

Type domainIntel

type domainIntel struct
type domainIntel struct {
	pangea.BaseService
}