Detección de amenazas
Listar amenazas de la organización
List every asset your organization has reported, with the lifecycle state of each investigation: report opened, escalated, blocklisted, takedown submitted, takedown completed. Built for threat-intel platforms that poll for changes and upsert on asset ID. Supports pagination.
GET
List organization threats
Descripción general
Lista todos los assets (activos digitales: URL, direcciones, perfiles, apps, etc.) reportados para tu organización, ya sea por tu equipo o por ChainPatrol, junto con el estado en que se encuentra cada uno: todavía en investigación, escalado a ti, bloqueado o permitido, y qué tan avanzado va su takedown (solicitud de baja de contenido fraudulento). Úsalo para mantener una plataforma de inteligencia de amenazas, un SIEM o un sistema de tickets sincronizado con ChainPatrol. Recórrelo página por página una vez para hacer la carga inicial (backfill); después consulta periódicamente conupdatedSince y
haz un upsert de cada fila usando id.
Para listar solo las amenazas confirmadas que se bloquearon en un rango de fechas, usa
/threats/list. Para listar las detecciones sin confirmar, usa
/detection/list.
Inicio rápido
Autenticación
Incluye tu clave de API en el encabezadoX-API-KEY. Las claves de API de organización determinan la
organización a partir de la clave, así que slug es opcional para ellas.
Solicitud de ejemplo
Parámetros de consulta
Estados del ciclo de vida
state resume los reportes de cada asset y la decisión que se tomó sobre él:
Una decisión sobre el asset prevalece sobre los reportes abiertos: una vez que está bloqueado o permitido,
state se queda ahí aunque alguien lo vuelva a reportar. Un asset que fue escalado,
decidido y luego reportado otra vez vuelve a investigating.
Las marcas de tiempo de cada amenaza:
firstReportedAt: el primer reporte para tu organización.escalatedAt: la primera vez que el asset se escaló a tu organización, onullsi nunca se escaló.blockedAt: cuándo se bloqueó el asset, onull.takedown:nullhasta que se abre un takedown.submittedAtes la primera vez que se presentó ante un proveedor, ycompletedAtla primera vez que se completó. Si el sitio vuelve a aparecer, el takedown se reabre:statusvuelve aIN_PROGRESSmientras quecompletedAtconserva la primera finalización. Vigilastatuspara detectar reapariciones.updatedAt: el cambio más reciente en el asset, sus reportes o su takedown. Este es el valor contra el que se comparaupdatedSince.
Consultar cambios periódicamente
- Carga inicial (backfill). Llama sin
updatedSincey siguenext_pagehasta que seanull. Anota la hora en que empezaste. - Consulta periódica (polling). Envía
updatedSincecon un valor unos minutos anterior al inicio de tu última sincronización exitosa, y siguenext_pagehasta que seanull, manteniendo el mismoupdatedSinceen cada página. Haz un upsert de cada amenaza usandoid. - Avanza. Usa la hora de inicio de esta sincronización como marca de referencia (watermark) para la siguiente.
id del asset, de forma ascendente, y el cursor es el último id devuelto,
así que los assets reportados a mitad de la sincronización quedan en páginas posteriores en lugar de desplazar las anteriores. Una
página puede contener menos amenazas que per_page mientras next_page todavía tiene un valor; continúa
hasta que next_page sea null.
Autorizaciones
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.
Parámetros de consulta
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