Skip to main content
POST
Get organization time-to-takedown metrics

Overview

Get the median time from a takedown starting to its completion, for takedowns completed in a date range: one median pooled across everything in scope (overall) and one per asset type (byAssetType). The clock starts when the takedown first moves to In Progress, or when it was opened if it never did, and stops the first time it is completed.

Request Body

Crypto address (ADDRESS) takedowns are left out unless you filter to them with assetTypes or the CRYPTO group. An address is reported on many sites at once, and how long that takes depends on how many platforms you want covered, so it would skew the median for domains and socials. excludedAssetTypes in the response lists what was left out.

Reading the response

  • Each median is given in minutes, hours and days. count is the number of completed takedowns behind it.
  • overall is the median of every takedown in scope, not a median of the per-type medians, so you cannot work it out from byAssetType. It is null when no takedown in scope completed in the range.
For the same median per hosting provider or registrar, use /metrics/takedown-time/by-provider. For month-by-month figures, use /metrics/takedown-time/trend.

Authorizations

X-API-KEY
string
header
required

Your API key. This is required by most endpoints to access our API programatically. Reach out to us at support@chainpatrol.io to get an API key for your use.

Body

application/json
slug
string
required

Organization slug

Minimum string length: 1
startDate
string

Only include takedowns completed on or after this date. A date-only value (YYYY-MM-DD) starts at midnight UTC

endDate
string

Only include takedowns completed on or before this date. A date-only value (YYYY-MM-DD) covers the whole day in UTC; pass a full timestamp for a precise cut-off

blockLabel
string

Only include assets blocked with this review label, e.g. "Brand Impersonation", "Employee Impersonation" or "Targeting Org Users"

brandType
enum<string>

Only include assets belonging to brands of this type

Available options:
INDIVIDUAL,
ORGANIZATION,
PRODUCT
countryCodes
string[]

Only include assets scanned from these ISO 3166-1 alpha-2 countries

Required string length: 2
brandIds
integer[]

Only include assets belonging to these brands

Required range: x > 0
assetTypes
enum<string>[]

Only include takedowns of these asset types. Combined with assetTypeGroups as a union. When no asset-type filter is given, crypto address (ADDRESS) takedowns are left out: an address is reported on many sites at once and how long its takedown takes depends on how many platforms you want covered, so it would skew the median for domains and socials. Filter to ADDRESS (or the CRYPTO group) to include them.

Available options:
URL,
PAGE,
ADDRESS,
DISCORD,
LINKEDIN,
TWITTER,
FACEBOOK,
YOUTUBE,
REDDIT,
TELEGRAM,
GOOGLE_APP_STORE,
APPLE_APP_STORE,
AMAZON_APP_STORE,
MICROSOFT_APP_STORE,
TIKTOK,
INSTAGRAM,
THREADS,
MEDIUM,
CHROME_WEB_STORE,
MOZILLA_ADDONS,
OPERA_ADDONS,
EMAIL,
PATREON,
OPENSEA,
FARCASTER,
IPFS,
GOOGLE_FORM,
WHATSAPP,
DISCORD_USER,
QUORA,
GITHUB,
TEACHABLE,
SUBSTACK,
DEBANK,
TAWK_TO,
JOTFORM,
PRIMAL,
BLUESKY,
SNAPCHAT,
DESO,
PINTEREST,
FLICKR,
GALXE,
VELOG,
NPM,
PYPI,
HEX,
DOCKER_HUB,
VOCAL_MEDIA,
TECKFINE,
TENDERLY,
HACKMD,
ETSY,
ZAZZLE,
BASENAME,
BILIBILI_TV,
VIMEO,
DAILYMOTION,
PHONE_NUMBER,
SLACK,
CALENDLY,
NGROK,
RARIBLE,
RUST_PACKAGE,
FLATHUB,
VIDLII,
VEVIOZ,
ISSUU,
SOUNDCLOUD,
ZAPPER,
REDNOTE,
SAMSUNG_APP_STORE,
HUAWEI_APP_STORE,
XIAOMI_APP_STORE,
TENCENT_APP_STORE,
OPPO_APP_STORE,
VIVO_APP_STORE,
F_DROID,
GOOGLE_AD,
BING_AD,
TWITCH,
BEHANCE,
ZORA,
META_AD,
SIGNAL,
DEVIANTART,
BANDCAMP,
ARCHIVE_ORG,
FIVE_HUNDRED_PX,
LUMA,
SMARTMONEYMATCH,
APK_GOLD,
GLASSDOOR,
PUMP_FUN,
TUMBLR,
MASTODON
assetTypeGroups
enum<string>[]

Only include takedowns whose asset type is in one of these groups — the same groups as the app's asset-type filter, e.g. DOMAINS or SOCIALS. Combined with assetTypes as a union

Available options:
DOMAINS,
SOCIALS,
APP_STORES,
ADS,
EXTENSIONS,
CRYPTO,
EMAIL,
PACKAGES,
OTHER

Response

Successful response

overall
object | null
required

One median pooled across every completed takedown in scope, across all of the selected asset types (or every type but excludedAssetTypes). Not derivable from byAssetType: a median of medians is not the median. Null when no takedown in scope completed in the range

byAssetType
object[]
required

Median time from takedown start to completion, one entry per asset type, ascending by median

excludedAssetTypes
enum<string>[]
required

Asset types left out of this result because no asset-type filter was given. Empty when the result covers exactly the asset types requested

Available options:
URL,
PAGE,
ADDRESS,
DISCORD,
LINKEDIN,
TWITTER,
FACEBOOK,
YOUTUBE,
REDDIT,
TELEGRAM,
GOOGLE_APP_STORE,
APPLE_APP_STORE,
AMAZON_APP_STORE,
MICROSOFT_APP_STORE,
TIKTOK,
INSTAGRAM,
THREADS,
MEDIUM,
CHROME_WEB_STORE,
MOZILLA_ADDONS,
OPERA_ADDONS,
EMAIL,
PATREON,
OPENSEA,
FARCASTER,
IPFS,
GOOGLE_FORM,
WHATSAPP,
DISCORD_USER,
QUORA,
GITHUB,
TEACHABLE,
SUBSTACK,
DEBANK,
TAWK_TO,
JOTFORM,
PRIMAL,
BLUESKY,
SNAPCHAT,
DESO,
PINTEREST,
FLICKR,
GALXE,
VELOG,
NPM,
PYPI,
HEX,
DOCKER_HUB,
VOCAL_MEDIA,
TECKFINE,
TENDERLY,
HACKMD,
ETSY,
ZAZZLE,
BASENAME,
BILIBILI_TV,
VIMEO,
DAILYMOTION,
PHONE_NUMBER,
SLACK,
CALENDLY,
NGROK,
RARIBLE,
RUST_PACKAGE,
FLATHUB,
VIDLII,
VEVIOZ,
ISSUU,
SOUNDCLOUD,
ZAPPER,
REDNOTE,
SAMSUNG_APP_STORE,
HUAWEI_APP_STORE,
XIAOMI_APP_STORE,
TENCENT_APP_STORE,
OPPO_APP_STORE,
VIVO_APP_STORE,
F_DROID,
GOOGLE_AD,
BING_AD,
TWITCH,
BEHANCE,
ZORA,
META_AD,
SIGNAL,
DEVIANTART,
BANDCAMP,
ARCHIVE_ORG,
FIVE_HUNDRED_PX,
LUMA,
SMARTMONEYMATCH,
APK_GOLD,
GLASSDOOR,
PUMP_FUN,
TUMBLR,
MASTODON