Get Time to Takedown
Get the median time from takedown start to completion, broken down by asset type, for a date range. Crypto address (ADDRESS) takedowns are left out unless you filter to them: an address is reported on many sites at once and how long its takedown takes depends on how many platforms you want covered. excludedAssetTypes in the response lists what was left out.
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
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.
countis the number of completed takedowns behind it. overallis the median of every takedown in scope, not a median of the per-type medians, so you cannot work it out frombyAssetType. It isnullwhen no takedown in scope completed in the range.
/metrics/takedown-time/by-provider.
For month-by-month figures, use
/metrics/takedown-time/trend.Authorizations
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
Organization slug
1Only include takedowns completed on or after this date. A date-only value (YYYY-MM-DD) starts at midnight UTC
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
Only include assets blocked with this review label, e.g. "Brand Impersonation", "Employee Impersonation" or "Targeting Org Users"
Only include assets belonging to brands of this type
INDIVIDUAL, ORGANIZATION, PRODUCT Only include assets scanned from these ISO 3166-1 alpha-2 countries
2Only include assets belonging to these brands
x > 0Only 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.
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 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
DOMAINS, SOCIALS, APP_STORES, ADS, EXTENSIONS, CRYPTO, EMAIL, PACKAGES, OTHER Response
Successful response
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
Median time from takedown start to completion, one entry per asset type, ascending by median
Asset types left out of this result because no asset-type filter was given. Empty when the result covers exactly the asset types requested
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