Versions in this module Expand all Collapse all v0 v0.2.0 Oct 9, 2026 Changes in this version type AgentscanSelfCheckResult + Locked []string + PlanRequired string type BulkCheckResult + PlanRequired string type BulkEvent + Locked []string + PlanRequired string + VPNProvider string type BulkResult + Locked []string + VPNProvider string type Client + Edge *EdgeService + Gate *GateService + Sites *SitesService + type EdgeCheckParams struct + Headers map[string]string + HeadlessFlags map[string]bool + IP string + JA4 string + RequestID string + Site string + UserAgent string + type EdgeCheckResult struct + Agent *AgentscanVerdict + Class string + Degraded []string + Locked []string + Network *EdgeNetwork + PlanRequired string + Site *EdgeSite + type EdgeNetwork struct + ASN int64 + ASNName string + Anonymized bool + Country string + Evidence []string + NetworkClass string + Provider string + RiskScore int + VPNProvider string + type EdgeService struct + func (s *EdgeService) Check(ctx context.Context, params EdgeCheckParams) (*EdgeCheckResult, error) + type EdgeSite struct + ID string + Mode string + PolicyVersion int + type GateNetwork struct + Anonymized bool + Classification string + Provider string + VPNProvider string + type GateService struct + func (s *GateService) Verify(ctx context.Context, params GateVerifyParams) (*GateVerification, error) + type GateVerification struct + Action string + Class string + Confidence float64 + Hostname string + IPMatch bool + IssuedAt time.Time + Locked []string + Mode string + Network GateNetwork + PlanRequired string + Signals []string + Success bool + type GateVerifyParams struct + RemoteIP string + Secret string + Token string type Geolocation + Locked []string + PlanRequired string type LookupResult + Locked []string + PlanRequired string + VPNProvider string + WhoisStatus string type ProxyInfo + Evidence []string + Locked []string + PlanRequired string + VPNProvider string + type SitePolicy struct + Mode string + Policy map[string]string + Site string + UpdatedAt time.Time + Version int + type SitesService struct + func (s *SitesService) Policy(ctx context.Context, id string) (*SitePolicy, error) type VPNInfo + Evidence []string + Locked []string + PlanRequired string + VPNProvider string type Verdict + Evidence []string type WhoisInfo + WhoisStatus string v0.1.0 Oct 6, 2026 Changes in this version + const DefaultBaseURL + const Version + func IsAuth(err error) bool + func IsNotFound(err error) bool + func IsRateLimited(err error) bool + type APIError struct + Body []byte + Code string + Details map[string]any + Message string + Status int + func (e *APIError) Error() string + func (e *APIError) Invalid() []string + type ASNDetail struct + DatacenterRangePrefixes int + RangesLoaded bool + SamplePrefixes []ASNPrefix + VPNRangePrefixes int + type ASNDirectoryService struct + func (s *ASNDirectoryService) Get(ctx context.Context, asn string) (*ASNDetail, error) + func (s *ASNDirectoryService) Search(ctx context.Context, query string, params *ASNSearchParams) (*ASNSearchResult, error) + func (s *ASNDirectoryService) Top(ctx context.Context, params *ASNTopParams) (*ASNTopResult, error) + type ASNInfo struct + ASN string + Country string + IP string + Name string + Type string + type ASNPrefix struct + Addresses uint64 + Prefix string + Version int + type ASNSearchParams struct + Limit int + type ASNSearchResult struct + Count int + Query string + Results []ASNSummary + Total int + type ASNSummary struct + ASN uint32 + Addresses uint64 + IPv4Prefixes int + IPv6Prefixes int + Label string + NetworkType string + Org string + Prefixes int + type ASNTopParams struct + By string + Top int + type ASNTopResult struct + By string + Count int + Results []ASNSummary + Total int + type AccountService struct + func (s *AccountService) Limits(ctx context.Context) (*Limits, error) + func (s *AccountService) Usage(ctx context.Context) (*UsageSummary, error) + type AgentscanBatchLine struct + Headers map[string]string + IP string + JA4 string + Line int + UserAgent string + type AgentscanBatchOutcome struct + Action string + Class string + Confidence float64 + Error string + IP string + Line int + Signals map[string]any + UserAgent string + type AgentscanBatchResult struct + AsOf time.Time + ByClass map[string]int + Failed int + Processed int + Reason string + Results []AgentscanBatchOutcome + Submitted int + Truncated bool + type AgentscanCheckParams struct + Headers map[string]string + HeadlessFlags map[string]bool + IP string + JA4 string + RequestID string + UserAgent string + type AgentscanSelfCheckParams struct + Headers map[string]string + IP string + JA4 string + UserAgent string + type AgentscanSelfCheckResult struct + ASN *ASNInfo + Action string + AsOf time.Time + Class string + Confidence float64 + Geo *Geolocation + IP string + JA4 string + JA4Source string + Metered bool + Signals map[string]any + UserAgent string + type AgentscanService struct + func (s *AgentscanService) Allowlist(ctx context.Context) ([]AllowlistAgent, error) + func (s *AgentscanService) Batch(ctx context.Context, lines []AgentscanBatchLine) (*AgentscanBatchResult, error) + func (s *AgentscanService) Check(ctx context.Context, params AgentscanCheckParams) (*AgentscanVerdict, error) + func (s *AgentscanService) SelfCheck(ctx context.Context, params *AgentscanSelfCheckParams) (*AgentscanSelfCheckResult, error) + func (s *AgentscanService) Verify(ctx context.Context, params AgentscanVerifyParams) (*CrawlerVerification, error) + type AgentscanVerdict struct + Action string + Class string + Confidence float64 + Signals map[string]any + type AgentscanVerifyParams struct + Bot string + IP string + UserAgent string + type AllowlistAgent struct + CreatedAt time.Time + CustomerID *int + ID int64 + Ident string + Type string + VerificationMethod string + type Anchor struct + Day string + LastID int64 + RootHash string + type AnchoredVerification struct + Anchor *Anchor + At time.Time + BrokenAt int64 + Count int64 + OK bool + Yours int64 + type BulkCheckResult struct + Duplicates int + Invalid []string + Results []BulkResult + Submitted int + Summary map[string]int + Unique int + type BulkEvent struct + ASN string + ASNName string + ASNType string + Anonymized bool + Classification string + Confidence float64 + Country string + Error string + Failed int + Grade string + IP string + Index int + Input string + IsTorExit bool + Message string + Metered int + Processed int + Reason string + Score int + Total int + Type string + Verdict string + func (e *BulkEvent) Complete() bool + type BulkParams struct + IPs []string + Input string + type BulkResult struct + ASN string + ASNName string + ASNType string + Anonymized bool + Classification string + Confidence float64 + Country string + Deductions []Deduction + Grade string + IP string + InDatacenterRange bool + InVPNRange bool + Input string + IsTorExit bool + Port int + Score int + Verdict string + type BulkService struct + func (s *BulkService) Check(ctx context.Context, params BulkParams) (*BulkCheckResult, error) + func (s *BulkService) Stream(ctx context.Context, params BulkParams) iter.Seq2[*BulkEvent, error] + type ChainLink struct + Anonymized bool + ClaimedJurisdiction string + Confidence float64 + EntryHash string + EntryOK bool + ID int64 + IP string + LinkOK bool + Method string + NetworkOrigin string + PolicyAction string + PrevHash string + PrevID int64 + Ts time.Time + type ChainPage struct + Anchor *Anchor + AsOf time.Time + Jurisdictions []Jurisdiction + Links []ChainLink + NextBefore int64 + Summary ChainSummary + Total int64 + type ChainParams struct + Before int64 + Limit int + type ChainSummary struct + Allow int64 + Block int64 + StepUp int64 + type ChainVerification struct + BrokenAt int64 + Count int64 + OK bool + type Client struct + ASNDirectory *ASNDirectoryService + Account *AccountService + Agentscan *AgentscanService + Bulk *BulkService + Crawlers *CrawlersService + IP *IPService + Provenance *ProvenanceService + func NewClient(opts ...Option) *Client + type ConnectionError struct + Err error + func (e *ConnectionError) Error() string + func (e *ConnectionError) Unwrap() error + type Crawler struct + ASNs []int + Docs string + Method string + Name string + Note string + PrefixFiles []string + ReverseDNS []string + Slug string + Tokens []string + Verifiable bool + type CrawlerList struct + Count int + Crawlers []Crawler + Note string + type CrawlerVerification struct + ASN string + ASNName string + Anonymized bool + CheckedAt time.Time + Checks []VerifyCheck + Country string + Crawler string + Docs string + Hostname string + IP string + Method string + NetworkOrigin string + Outcome string + Slug string + Summary string + UserAgent string + type CrawlersService struct + func (s *CrawlersService) List(ctx context.Context) (*CrawlerList, error) + type Deduction struct + Detail string + Factor string + Points int + type ExportParams struct + From string + To string + type Geolocation struct + AccuracyRadius int + City string + Country string + CountryCode string + IP string + Latitude float64 + Longitude float64 + PostalCode string + Region string + Timezone string + type History struct + AsOf time.Time + Events []HistoryEvent + NextBefore int64 + type HistoryEvent struct + ASN string + ASNName string + Anonymized bool + At time.Time + Confidence float64 + Country string + ID int64 + IP string + Source string + Target string + Verdict string + type HistoryParams struct + Before int64 + Limit int + Verdict string + type IPService struct + func (s *IPService) ASN(ctx context.Context, ip string) (*ASNInfo, error) + func (s *IPService) Demo(ctx context.Context, ip string) (*LookupResult, error) + func (s *IPService) Geo(ctx context.Context, ip string) (*Geolocation, error) + func (s *IPService) History(ctx context.Context, params *HistoryParams) (*History, error) + func (s *IPService) Lookup(ctx context.Context, target string) (*LookupResult, error) + func (s *IPService) MyIP(ctx context.Context) (*MyIP, error) + func (s *IPService) Proxy(ctx context.Context, ip string) (*ProxyInfo, error) + func (s *IPService) VPN(ctx context.Context, ip string) (*VPNInfo, error) + func (s *IPService) Whois(ctx context.Context, domain string) (*WhoisInfo, error) + type Jurisdiction struct + CleanAction string + Code string + Label string + Law string + MaskedAction string + Rule string + Strict bool + type Limits struct + AccountType string + Daily *Window + Hourly *Window + Limit int64 + Remaining int64 + ResetDate string + Usage int64 + type LookupResult struct + ASN *ASNInfo + At time.Time + Degraded []string + Geo *Geolocation + IsProxy bool + IsTor bool + IsVPN bool + NetworkClass string + NetworkType string + Provider string + Purity Purity + Reserved Reserved + RiskScore int + Target Target + Verdict Verdict + Whois *WhoisInfo + type MyIP struct + ASN string + ASNCountry string + ASNName string + ASNType string + AccuracyRadius int + City string + Country string + CountryCode string + IPv4 string + IPv6 string + Latitude float64 + Longitude float64 + PostalCode string + Region string + Timezone string + type Option func(*Client) + func WithAPIKey(key string) Option + func WithBaseURL(u string) Option + func WithHTTPClient(hc *http.Client) Option + func WithMaxRetries(n int) Option + func WithTimeout(d time.Duration) Option + func WithUserAgent(ua string) Option + type ProvenanceCheckParams struct + ClaimedJurisdiction string + IP string + RequestContext map[string]any + type ProvenanceCheckResult struct + Anonymized bool + AttestationID int64 + Confidence float64 + Method string + NetworkOrigin string + PolicyAction string + type ProvenanceService struct + func (s *ProvenanceService) Chain(ctx context.Context, params *ChainParams) (*ChainPage, error) + func (s *ProvenanceService) Check(ctx context.Context, params ProvenanceCheckParams) (*ProvenanceCheckResult, error) + func (s *ProvenanceService) Export(ctx context.Context, params *ExportParams) ([]byte, error) + func (s *ProvenanceService) Jurisdictions(ctx context.Context) ([]Jurisdiction, error) + func (s *ProvenanceService) Verify(ctx context.Context) (*ChainVerification, error) + func (s *ProvenanceService) VerifyAnchored(ctx context.Context) (*AnchoredVerification, error) + type ProxyInfo struct + Anonymized bool + IP string + IsProxy bool + IsTor bool + NetworkClass string + Provider string + RiskScore int + type Purity struct + Deductions []Deduction + Grade string + Score int + Verdict string + type RateLimitError struct + Limit int64 + Needed int64 + Plan string + RateLimit RateLimitHeaders + Reason string + RecommendedPlan string + Remaining int64 + ResetAt time.Time + ResetDate string + RetryAfter time.Duration + SoftBlock bool + UpgradeURL string + Usage int64 + func (e *RateLimitError) Error() string + func (e *RateLimitError) Unwrap() error + type RateLimitHeaders struct + DailyLimit int64 + DailyRemaining int64 + DailyReset time.Time + HourlyLimit int64 + HourlyRemaining int64 + HourlyReset time.Time + Limit int64 + Meter string + Remaining int64 + Reset time.Time + RetryAfter time.Duration + UpgradeHint string + UpgradePlan string + UpgradeURL string + UsagePercent int64 + type Reserved struct + Detail string + Label string + Reserved bool + type Target struct + Addresses int64 + Hostname string + IP string + Kind string + Network string + Raw string + type UsageSummary struct + AsOf time.Time + BlockedBy string + BulkCap int + Daily *Window + Hourly *Window + Limit int64 + Percent float64 + PeriodStart string + Plan string + Remaining int64 + ResetDate string + SoftBlocked bool + Unlimited bool + UpgradeHint bool + Used int64 + type VPNInfo struct + Anonymized bool + IP string + IsTor bool + IsVPN bool + NetworkClass string + Provider string + RiskScore int + type Verdict struct + Anonymized bool + Classification string + Confidence float64 + Method string + type VerifyCheck struct + Detail string + Name string + Status string + type WhoisInfo struct + Domain string + ExpiresOn string + LastUpdated string + Nameservers []string + PrivacyProtection bool + RegisteredOn string + Registrar string + Status []string + type Window struct + Limit int64 + Remaining int64 + ResetAt time.Time + Used int64