Get Multiple Domain Details

client.Intel.Domains.Bulks.Get(ctx, params) (*[]DomainBulkGetResponse, error)

GET/accounts/{account_id}/intel/domain/bulk

Returns security details and statistics about multiple domains in a single request.

Behavior change — domain ranking is becoming opt-in. This endpoint previously included domain ranking data in every response and accepted a skip_ranking=true query parameter to opt out. That parameter is being deprecated and ranking will no longer be returned by default. Callers that want ranking data must pass include_ranking=true. The skip_ranking parameter will be silently ignored once the change ships.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Accepted Permissions (at least one required)

Intel WriteIntel Read

ParametersExpand Collapse

params DomainBulkGetParams

AccountID param.Field[string]

Path param: Identifier.

maxLength32

Domain param.Field[[]string]Optional

Query param: Accepts multiple values like ?domain=cloudflare.com&domain=example.com.

IncludeRanking param.Field[bool]Optional

Query param: Whether to include domain ranking data in the response. Defaults to false — ranking lookups are expensive at bulk scale and most callers do not need them. Set to true to opt in. This parameter replaces the deprecated skip_ranking (see below).

SkipRanking param.Field[bool]Optional

Query param: Deprecated. Previously controlled whether the ranking lookup was skipped (defaulted to false, meaning ranking ran). The endpoint’s default behavior is being flipped — ranking is now opt-in via include_ranking=true — and this parameter will be silently ignored. Remove it from your callers and use include_ranking instead.

ReturnsExpand Collapse

type DomainBulkGetResponseEnvelopeResult []DomainBulkGetResponse

AdditionalInformation DomainBulkGetResponseAdditionalInformationOptional

Additional information related to the host name.

SuspectedMalwareFamily stringOptional

Suspected DGA malware family.

Application DomainBulkGetResponseApplicationOptional

Application that the hostname belongs to.

ID int64Optional

Name stringOptional

ContentCategories []DomainBulkGetResponseContentCategoryOptional

ID int64Optional

Name stringOptional

SuperCategoryID int64Optional

Domain stringOptional

InheritedContentCategories []DomainBulkGetResponseInheritedContentCategoryOptional

ID int64Optional

Name stringOptional

SuperCategoryID int64Optional

InheritedFrom stringOptional

Domain from which inherited_content_categories and inherited_risk_types are inherited, if applicable.

InheritedRiskTypes []DomainBulkGetResponseInheritedRiskTypeOptional

ID int64Optional

Name stringOptional

SuperCategoryID int64Optional

PopularityRank int64Optional

Global Cloudflare 100k ranking for the last 30 days, if available for the hostname. The top ranked domain is 1, the lowest ranked domain is 100,000.

RiskScore float64Optional

Hostname risk score, which is a value between 0 (lowest risk) to 1 (highest risk).

RiskTypes []DomainBulkGetResponseRiskTypeOptional

ID int64Optional

Name stringOptional

SuperCategoryID int64Optional

Get Multiple Domain Details

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/cloudflare-go"
  "github.com/stainless-sdks/cloudflare-go/intel"
  "github.com/stainless-sdks/cloudflare-go/option"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  bulks, err := client.Intel.Domains.Bulks.Get(context.TODO(), intel.DomainBulkGetParams{
    AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", bulks)
}

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": [
    {
      "additional_information": {
        "suspected_malware_family": ""
      },
      "application": {
        "id": 0,
        "name": "CLOUDFLARE"
      },
      "content_categories": [
        {
          "id": 155,
          "name": "Technology",
          "super_category_id": 26
        }
      ],
      "domain": "cloudflare.com",
      "inherited_content_categories": [
        {
          "id": 0,
          "name": "name",
          "super_category_id": 0
        }
      ],
      "inherited_from": "inherited_from",
      "inherited_risk_types": [
        {
          "id": 0,
          "name": "name",
          "super_category_id": 0
        }
      ],
      "popularity_rank": 0,
      "risk_score": 0,
      "risk_types": [
        {
          "id": 0,
          "name": "name",
          "super_category_id": 0
        }
      ]
    }
  ],
  "success": true,
  "result_info": {
    "count": 1,
    "page": 1,
    "per_page": 20,
    "total_count": 2000
  }
}

Returns Examples

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": [
    {
      "additional_information": {
        "suspected_malware_family": ""
      },
      "application": {
        "id": 0,
        "name": "CLOUDFLARE"
      },
      "content_categories": [
        {
          "id": 155,
          "name": "Technology",
          "super_category_id": 26
        }
      ],
      "domain": "cloudflare.com",
      "inherited_content_categories": [
        {
          "id": 0,
          "name": "name",
          "super_category_id": 0
        }
      ],
      "inherited_from": "inherited_from",
      "inherited_risk_types": [
        {
          "id": 0,
          "name": "name",
          "super_category_id": 0
        }
      ],
      "popularity_rank": 0,
      "risk_score": 0,
      "risk_types": [
        {
          "id": 0,
          "name": "name",
          "super_category_id": 0
        }
      ]
    }
  ],
  "success": true,
  "result_info": {
    "count": 1,
    "page": 1,
    "per_page": 20,
    "total_count": 2000
  }
}