Skip to main content

URL Intel | Golang SDK

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

Reputation check

func (e *urlIntel) Reputation(ctx context.Context, input *UrlReputationRequest) (*pangea.PangeaResponse[UrlReputationResult], error)

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

required parameters

context.Context
input := &url_intel.UrlReputationRequest{
	Url:      "http://113.235.101.11:54384",
	Raw:      true,
	Verbose:  true,
	Provider: "crowdstrike",
}

checkOutput, err := urlintel.Reputation(ctx, input)

Reputation check V2

func (e *urlIntel) ReputationBulk(ctx context.Context, input *UrlReputationBulkRequest) (*pangea.PangeaResponse[UrlReputationBulkResult], error)

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

required parameters

context.Context
urls := [...]string{"http://113.235.101.11:54384"}

input := &url_intel.UrlReputationBulkRequest{
	Urls:     urls,
	Raw:      true,
	Verbose:  true,
	Provider: "crowdstrike",
}

checkOutput, err := urlintel.ReputationBulk(ctx, input)

Type Client

type Client interface

required parameters

func(ctx context.Context, req *UrlReputationRequest) (*pangea.PangeaResponse[UrlReputationResult], error)
context.Context
func(ctx context.Context, req *UrlReputationBulkRequest) (*pangea.PangeaResponse[UrlReputationBulkResult], error)
context.Context
pangea.BaseServicer

Base service methods

type Client interface {
	Reputation(ctx context.Context, req *UrlReputationRequest) (*pangea.PangeaResponse[UrlReputationResult], error)
	ReputationBulk(ctx context.Context, req *UrlReputationBulkRequest) (*pangea.PangeaResponse[UrlReputationBulkResult], error)

	// Base service methods
	pangea.BaseServicer
}

Type ReputationData

type ReputationData struct

required parameters

[]string `json:"category"`
int `json:"score"`
string `json:"verdict"`
type ReputationData struct {
	Category	[]string	`json:"category"`
	Score		int		`json:"score"`
	Verdict		string		`json:"verdict"`
}

Type UrlReputationBulkRequest

type UrlReputationBulkRequest struct

required parameters

pangea.BaseRequest

Base request has ConfigID for multi-config projects

[]string `json:"urls"`

The URL 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 UrlReputationBulkRequest struct {
	// Base request has ConfigID for multi-config projects
	pangea.BaseRequest

	// The URL to be looked up
	Urls	[]string	`json:"urls"`

	// 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 UrlReputationBulkResult

type UrlReputationBulkResult 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 UrlReputationBulkResult 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 UrlReputationRequest

type UrlReputationRequest struct

required parameters

pangea.BaseRequest

Base request has ConfigID for multi-config projects

string `json:"url"`
*bool `json:"verbose,omitempty"`
*bool `json:"raw,omitempty"`
string `json:"provider,omitempty"`
type UrlReputationRequest struct {
	// Base request has ConfigID for multi-config projects
	pangea.BaseRequest

	Url		string	`json:"url"`
	Verbose		*bool	`json:"verbose,omitempty"`
	Raw		*bool	`json:"raw,omitempty"`
	Provider	string	`json:"provider,omitempty"`
}

Type UrlReputationResult

type UrlReputationResult struct

required parameters

ReputationData `json:"data"`
interface{} `json:"parameters,omitempty"`
interface{} `json:"raw_data,omitempty"`
type UrlReputationResult struct {
	Data		ReputationData	`json:"data"`
	Parameters	interface{}	`json:"parameters,omitempty"`
	RawData		interface{}	`json:"raw_data,omitempty"`
}

Type urlIntel

type urlIntel struct
type urlIntel struct {
	pangea.BaseService
}