---
title: Brand Protection
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/go)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Brand Protection

##### [Create new URL submissions](https://developers.cloudflare.com/api/go/resources/brand_protection/methods/submit)

client.BrandProtection.Submit(ctx, body) (\*[BrandProtectionSubmitResponse](<https://developers.cloudflare.com/api/go/resources/brand_protection#(resource)%20brand_protection%20%3E%20(model)%20BrandProtectionSubmitResponse%20%3E%20(schema)>), error)

POST/accounts/{account\_id}/brand-protection/submit

##### [Read submitted URLs by ID](https://developers.cloudflare.com/api/go/resources/brand_protection/methods/url_info)

client.BrandProtection.URLInfo(ctx, query) (\*SinglePage\[[BrandProtectionURLInfoResponse](<https://developers.cloudflare.com/api/go/resources/brand_protection#(resource)%20brand_protection%20%3E%20(model)%20BrandProtectionURLInfoResponse%20%3E%20(schema)>)], error)

GET/accounts/{account\_id}/brand-protection/url-info

##### ModelsExpand Collapse

<details>

<summary>

type Info struct{…}

</summary>

<details>

<summary>

Categorizations \[]InfoCategorizationOptional

List of categorizations applied to this submission.

</summary>

Category stringOptional

Name of the category applied.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20categorizations%20%3E%20(items)%20%3E%20(property)%20category">Link to this property</a>

VerificationStatus stringOptional

Result of human review for this categorization.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20categorizations%20%3E%20(items)%20%3E%20(property)%20verification_status">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20categorizations">Link to this property</a>

<details>

<summary>

ModelResults \[]InfoModelResultOptional

List of model results for completed scans.

</summary>

ModelName stringOptional

Name of the model.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20model_results%20%3E%20(items)%20%3E%20(property)%20model_name">Link to this property</a>

ModelScore float64Optional

This is the score that is outputted by the model for this submission.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20model_results%20%3E%20(items)%20%3E%20(property)%20model_score">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20model_results">Link to this property</a>

<details>

<summary>

RuleMatches \[]InfoRuleMatchOptional

List of signatures that matched against site content found when crawling the URL.

</summary>

Banning boolOptional

For internal use.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20rule_matches%20%3E%20(items)%20%3E%20(property)%20banning">Link to this property</a>

Blocking boolOptional

For internal use.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20rule_matches%20%3E%20(items)%20%3E%20(property)%20blocking">Link to this property</a>

Description stringOptional

Description of the signature that matched.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20rule_matches%20%3E%20(items)%20%3E%20(property)%20description">Link to this property</a>

Name stringOptional

Name of the signature that matched.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20rule_matches%20%3E%20(items)%20%3E%20(property)%20name">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20rule_matches">Link to this property</a>

<details>

<summary>

ScanStatus InfoScanStatusOptional

Status of the most recent scan found.

</summary>

LastProcessed stringOptional

Timestamp of when the submission was processed.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20scan_status%20%3E%20(property)%20last_processed">Link to this property</a>

ScanComplete boolOptional

For internal use.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20scan_status%20%3E%20(property)%20scan_complete">Link to this property</a>

StatusCode int64Optional

Status code that the crawler received when loading the submitted URL.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20scan_status%20%3E%20(property)%20status_code">Link to this property</a>

SubmissionID int64Optional

ID of the most recent submission.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20scan_status%20%3E%20(property)%20submission_id">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20scan_status">Link to this property</a>

ScreenshotDownloadSignature stringOptional

For internal use.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20screenshot_download_signature">Link to this property</a>

ScreenshotPath stringOptional

For internal use.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20screenshot_path">Link to this property</a>

URL stringOptional

URL that was submitted.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)%20%3E%20(property)%20url">Link to this property</a>

</details>

[Link to this property](<#(resource)%20brand_protection%20%3E%20(model)%20info%20%3E%20(schema)>)

<details>

<summary>

type Submit struct{…}

</summary>

<details>

<summary>

ExcludedURLs \[]SubmitExcludedURLOptional

URLs that were excluded from scanning because their domain is in our no-scan list.

</summary>

URL stringOptional

URL that was excluded.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20submit%20%3E%20(schema)%20%3E%20(property)%20excluded_urls%20%3E%20(items)%20%3E%20(property)%20url">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection%20%3E%20(model)%20submit%20%3E%20(schema)%20%3E%20(property)%20excluded_urls">Link to this property</a>

<details>

<summary>

SkippedURLs \[]SubmitSkippedURLOptional

URLs that were skipped because the same URL is currently being scanned.

</summary>

URL stringOptional

URL that was skipped.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20submit%20%3E%20(schema)%20%3E%20(property)%20skipped_urls%20%3E%20(items)%20%3E%20(property)%20url">Link to this property</a>

URLID int64Optional

ID of the submission of that URL that is currently scanning.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20submit%20%3E%20(schema)%20%3E%20(property)%20skipped_urls%20%3E%20(items)%20%3E%20(property)%20url_id">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection%20%3E%20(model)%20submit%20%3E%20(schema)%20%3E%20(property)%20skipped_urls">Link to this property</a>

<details>

<summary>

SubmittedURLs \[]SubmitSubmittedURLOptional

URLs that were successfully submitted for scanning.

</summary>

URL stringOptional

URL that was submitted.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20submit%20%3E%20(schema)%20%3E%20(property)%20submitted_urls%20%3E%20(items)%20%3E%20(property)%20url">Link to this property</a>

URLID int64Optional

ID assigned to this URL submission. Used to retrieve scanning results.

<a href="#(resource)%20brand_protection%20%3E%20(model)%20submit%20%3E%20(schema)%20%3E%20(property)%20submitted_urls%20%3E%20(items)%20%3E%20(property)%20url_id">Link to this property</a>

</details>

<a href="#(resource)%20brand_protection%20%3E%20(model)%20submit%20%3E%20(schema)%20%3E%20(property)%20submitted_urls">Link to this property</a>

</details>

[Link to this property](<#(resource)%20brand_protection%20%3E%20(model)%20submit%20%3E%20(schema)>)

#### Brand ProtectionQueries

##### [Create new saved string queries](https://developers.cloudflare.com/api/go/resources/brand_protection/subresources/queries/methods/create)

client.BrandProtection.Queries.New(ctx, params) error

POST/accounts/{account\_id}/brand-protection/queries

##### [Delete saved string queries by ID](https://developers.cloudflare.com/api/go/resources/brand_protection/subresources/queries/methods/delete)

client.BrandProtection.Queries.Delete(ctx, params) error

DELETE/accounts/{account\_id}/brand-protection/queries

##### [Create new saved string queries in bulk](https://developers.cloudflare.com/api/go/resources/brand_protection/subresources/queries/methods/bulk)

client.BrandProtection.Queries.Bulk(ctx, params) error

POST/accounts/{account\_id}/brand-protection/queries/bulk

#### Brand ProtectionMatches

##### [Read matches for string queries by ID](https://developers.cloudflare.com/api/go/resources/brand_protection/subresources/matches/methods/get)

client.BrandProtection.Matches.Get(ctx, params) (\*[MatchGetResponse](<https://developers.cloudflare.com/api/go/resources/brand_protection#(resource)%20brand_protection.matches%20%3E%20(model)%20MatchGetResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/brand-protection/matches

##### [Download matches for string queries by ID](https://developers.cloudflare.com/api/go/resources/brand_protection/subresources/matches/methods/download)

client.BrandProtection.Matches.Download(ctx, params) (\*[MatchDownloadResponse](<https://developers.cloudflare.com/api/go/resources/brand_protection#(resource)%20brand_protection.matches%20%3E%20(model)%20MatchDownloadResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/brand-protection/matches/download

#### Brand ProtectionLogos

##### [Create new saved logo queries from image files](https://developers.cloudflare.com/api/go/resources/brand_protection/subresources/logos/methods/create)

client.BrandProtection.Logos.New(ctx, params) (\*[LogoNewResponse](<https://developers.cloudflare.com/api/go/resources/brand_protection#(resource)%20brand_protection.logos%20%3E%20(model)%20LogoNewResponse%20%3E%20(schema)>), error)

POST/accounts/{account\_id}/brand-protection/logos

##### [Delete saved logo queries by ID](https://developers.cloudflare.com/api/go/resources/brand_protection/subresources/logos/methods/delete)

client.BrandProtection.Logos.Delete(ctx, logoID, body) error

DELETE/accounts/{account\_id}/brand-protection/logos/{logo\_id}

#### Brand ProtectionLogo Matches

##### [Read matches for logo queries by ID](https://developers.cloudflare.com/api/go/resources/brand_protection/subresources/logo_matches/methods/get)

client.BrandProtection.LogoMatches.Get(ctx, params) (\*[LogoMatchGetResponse](<https://developers.cloudflare.com/api/go/resources/brand_protection#(resource)%20brand_protection.logo_matches%20%3E%20(model)%20LogoMatchGetResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/brand-protection/logo-matches

##### [Download matches for logo queries by ID](https://developers.cloudflare.com/api/go/resources/brand_protection/subresources/logo_matches/methods/download)

client.BrandProtection.LogoMatches.Download(ctx, params) (\*[LogoMatchDownloadResponse](<https://developers.cloudflare.com/api/go/resources/brand_protection#(resource)%20brand_protection.logo_matches%20%3E%20(model)%20LogoMatchDownloadResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/brand-protection/logo-matches/download

#### Brand ProtectionV2

#### Brand ProtectionV2Queries

##### [Get queries](https://developers.cloudflare.com/api/go/resources/brand_protection/subresources/v2/subresources/queries/methods/get)

client.BrandProtection.V2.Queries.Get(ctx, params) (\*[V2QueryGetResponseUnion](<https://developers.cloudflare.com/api/go/resources/brand_protection#(resource)%20brand_protection.v2.queries%20%3E%20(model)%20V2QueryGetResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/cloudforce-one/v2/brand-protection/domain/queries

#### Brand ProtectionV2Matches

##### [List saved query matches](https://developers.cloudflare.com/api/go/resources/brand_protection/subresources/v2/subresources/matches/methods/get)

client.BrandProtection.V2.Matches.Get(ctx, params) (\*[V2MatchGetResponse](<https://developers.cloudflare.com/api/go/resources/brand_protection#(resource)%20brand_protection.v2.matches%20%3E%20(model)%20V2MatchGetResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/cloudforce-one/v2/brand-protection/domain/matches

#### Brand ProtectionV2Logos

##### [Insert logo query](https://developers.cloudflare.com/api/go/resources/brand_protection/subresources/v2/subresources/logos/methods/create)

client.BrandProtection.V2.Logos.New(ctx, params) (\*[V2LogoNewResponse](<https://developers.cloudflare.com/api/go/resources/brand_protection#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20V2LogoNewResponse%20%3E%20(schema)>), error)

POST/accounts/{account\_id}/cloudforce-one/v2/brand-protection/logo/queries

##### [Delete logo query](https://developers.cloudflare.com/api/go/resources/brand_protection/subresources/v2/subresources/logos/methods/delete)

client.BrandProtection.V2.Logos.Delete(ctx, queryID, body) (\*[V2LogoDeleteResponse](<https://developers.cloudflare.com/api/go/resources/brand_protection#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20V2LogoDeleteResponse%20%3E%20(schema)>), error)

DELETE/accounts/{account\_id}/cloudforce-one/v2/brand-protection/logo/queries/{query\_id}

##### [Get logo queries](https://developers.cloudflare.com/api/go/resources/brand_protection/subresources/v2/subresources/logos/methods/get)

client.BrandProtection.V2.Logos.Get(ctx, params) (\*\[] [V2LogoGetResponse](<https://developers.cloudflare.com/api/go/resources/brand_protection#(resource)%20brand_protection.v2.logos%20%3E%20(model)%20V2LogoGetResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/cloudforce-one/v2/brand-protection/logo/queries

#### Brand ProtectionV2Logo Matches

##### [List logo matches](https://developers.cloudflare.com/api/go/resources/brand_protection/subresources/v2/subresources/logo_matches/methods/get)

client.BrandProtection.V2.LogoMatches.Get(ctx, params) (\*[V2LogoMatchGetResponse](<https://developers.cloudflare.com/api/go/resources/brand_protection#(resource)%20brand_protection.v2.logo_matches%20%3E%20(model)%20V2LogoMatchGetResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/cloudforce-one/v2/brand-protection/logo/matches