Click protection

GET

/api/v1/ads/protection

curl --request GET \
  --url https://digize.com/api/v1/ads/protection \
  --header 'x-api-key: <x-api-key>'

• Digize

Paid clicks the edge checked and caught over the last 30 days and why, the latest it caught, and the block list.

Needs the ads:read permission.

Authorizations

• apiKey
• bearer

Responses

200

Done

Media typeapplication/json

object

checked

required

Paid clicks checked over the last 30 days.

number

blocked

required

number

wastedSpend

required

What the caught clicks cost, at each platform’s cost per click.

number

reasons

required

Array<object>

object

reason

required

string

Allowed values: repeat_clicks click_flood data_center vpn_proxy automation browser_mismatch country block_list

count

required

number

recent

required

Array<object>

object

id

required

string

at

required

string format: date-time

campaign

required

string

platform

required

string

Allowed values: google meta tiktok linkedin microsoft pinterest

ip

required

string

network

required

string

reason

required

string

Allowed values: repeat_clicks click_flood data_center vpn_proxy automation browser_mismatch country block_list

risk

required

number

rules

required

Array<object>

object

id

required

string

kind

required

string

Allowed values: ip network fingerprint

value

required

string

note

required

string

reasons

required

Array<string>

Allowed values: repeat_clicks click_flood data_center vpn_proxy automation browser_mismatch country block_list

hits

required

number

addedBy

required

Null when the scoring added it.

string | null

createdAt

required

string format: date-time

expiresAt

required

Any of:

string

string format: date-time

null

null

Example

{
  "reasons": [
    {
      "reason": "repeat_clicks"
    }
  ],
  "recent": [
    {
      "platform": "google",
      "reason": "repeat_clicks"
    }
  ],
  "rules": [
    {
      "kind": "ip",
      "reasons": [
        "repeat_clicks"
      ]
    }
  ]
}

400

What was sent isn’t valid (invalid).

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "invalid"
  }
}

401

No key, or one that’s unknown, off or expired.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "invalid"
  }
}

403

The key doesn’t have the permission this needs.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "invalid"
  }
}

404

Nothing has that id (not_found).

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "invalid"
  }
}

429

Over the rate limit; see retry-after.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "invalid"
  }
}