Saltar al contenido principal
POST
Get organization time-to-takedown metrics

Descripción general

Obtén la mediana del tiempo que pasa desde que un takedown (solicitud de baja de contenido fraudulento) comienza hasta que se completa, para los takedowns completados en un rango de fechas: una mediana global que agrupa todo lo que entra en el alcance (overall) y una por tipo de asset (activo digital: URL, dirección, perfil, app, etc.) (byAssetType). El reloj empieza cuando el takedown pasa por primera vez a IN_PROGRESS, o cuando se abrió si nunca pasó a ese estado, y se detiene la primera vez que se completa.

Cuerpo de la solicitud

Los takedowns de direcciones cripto (ADDRESS) quedan fuera, salvo que los filtres con assetTypes o con el grupo CRYPTO. Una dirección se reporta en muchos sitios a la vez, y cuánto tarda eso depende de cuántas plataformas quieras cubrir, así que distorsionaría la mediana de dominios y redes sociales. excludedAssetTypes en la respuesta indica lo que quedó fuera.

Cómo leer la respuesta

  • Cada mediana se expresa en minutos, horas y días. count es la cantidad de takedowns completados que la respaldan.
  • overall es la mediana de todos los takedowns dentro del alcance, no una mediana de las medianas por tipo, así que no puedes calcularla a partir de byAssetType. Es null cuando ningún takedown dentro del alcance se completó en el rango.
Para obtener la misma mediana por proveedor de hosting o registrador, usa /metrics/takedown-time/by-provider. Para obtener las cifras mes a mes, usa /metrics/takedown-time/trend.

Autorizaciones

X-API-KEY
string
header
requerido

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.

Cuerpo

application/json
slug
string
requerido

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

Opciones disponibles:
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

Rango requerido: 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.

Opciones disponibles:
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

Opciones disponibles:
DOMAINS,
SOCIALS,
APP_STORES,
ADS,
EXTENSIONS,
CRYPTO,
EMAIL,
PACKAGES,
OTHER

Respuesta

Successful response

overall
object | null
requerido

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[]
requerido

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

excludedAssetTypes
enum<string>[]
requerido

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

Opciones disponibles:
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