Insert logo query

POST/accounts/{account_id}/cloudforce-one/v2/brand-protection/logo/queries

Create a new saved brand protection logo query for visual similarity matching

Security

API Token

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

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

Accepted Permissions (at least one required)

Cloudforce One Write

Path ParametersExpand Collapse

account_id: string

minLength1

Body ParametersJSONExpand Collapse

image_data: string

Base64 encoded image data. Can include data URI prefix (e.g., ‘data:image/png;base64,…’) or just the base64 string.

minLength1

similarity_threshold: number

Minimum similarity score (0-1) required for visual matches

maximum1

minimum0

tag: string

Unique identifier for the logo query

minLength1

search_lookback: optional boolean

If true, search historic scanned images for matches above the similarity threshold

ReturnsExpand Collapse

message: string

success: boolean

query_id: optional number

Insert logo query

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/cloudforce-one/v2/brand-protection/logo/queries \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
    -d '{
          "image_data": "x",
          "similarity_threshold": 0,
          "tag": "x"
        }'

{
  "message": "message",
  "success": true,
  "query_id": 0
}

Returns Examples

{
  "message": "message",
  "success": true,
  "query_id": 0
}