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

Overview

Get the median time from a takedown starting to its completion, per provider the takedown was filed against, for takedowns completed in a date range. Use it to see which hosts and registrars act quickly and which are slow.

Request Body

Reading the response

  • byProvider has one entry per provider and role, fastest median first. A takedown filed against both a host and a registrar counts once under each.
  • count is the number of completed takedowns behind each median.
  • Crypto address (ADDRESS) takedowns are always left out, and excludedAssetTypes says so. See Time to Takedown for why.

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

roles
enum<string>[]

Only break down these provider roles. Omit for every role. A takedown filed against both a host and a registrar is counted once under each

Available options:
HOSTING_PROVIDER,
DOMAIN_REGISTRAR,
TLD_REGISTRAR
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

Response

Successful response

byProvider
object[]
required

Median time from takedown start to completion, one entry per provider and role, 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