Saltar al contenido principal
GET
List organization watchlist

Descripción general

Lista los assets (activos digitales: URL, direcciones, perfiles, apps, etc.) que ChainPatrol está vigilando para tu organización. Son assets que reportaste y que no se bloquearon —normalmente porque estaban inactivos, estacionados (parked), eran una plantilla o no tenían evidencia suficiente— y que ChainPatrol sigue reescaneando para poder bloquearlos si se vuelven maliciosos. Consulta La Watchlist de ChainPatrol (la Watchlist es la lista de seguimiento de assets sospechosos que se siguen monitoreando) para saber cómo llegan ahí los assets. Un asset se incluye cuando su vigilancia está activada y tu organización presentó un reporte contra él. Es el mismo conjunto que cuenta threatsWatchlisted en /metrics/summary, así que el total de aquí coincide con el número del Dashboard (panel principal).

Inicio rápido

Autenticación

Incluye tu clave de API en el encabezado X-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

reportedSince y reportedUntil filtran por el momento en que tu organización reportó el asset: la misma ventana que /metrics/summary usa para threatsWatchlisted. No filtran por el momento en que el asset se agregó a la Watchlist. Omite ambos para obtener la Watchlist completa.

Respuesta

next_page es null en la última página. total solo está presente cuando estableces includeTotal.

Paginación

Los resultados se ordenan por ID del asset, de forma ascendente. Vuelve a enviar next_page hasta que sea null. Los assets nuevos quedan después del cursor, así que un recorrido nunca repite ni omite una fila.

Relacionado

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.

Parámetros de consulta

slug
string
assetType
enum<string>
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
query
string

Only return assets whose content contains this text

reportedSince
string
reportedUntil
string
includeTotal
boolean
predeterminado:false

Also return total: how many watchlisted assets match the filters across all pages. Costs an extra count query, so request it on the first page rather than every page.

per_page
integer
predeterminado:100

The number of assets to return per page (max 1000)

Rango requerido: 1 <= x <= 1000
next_page
string | null

Cursor for fetching the next page of results

Respuesta

Successful response

Successful operation

watchlist
object[]
requerido
next_page
string | null

Cursor for fetching the next page of results, or null on the last page

total
number

How many watchlisted assets match the filters across all pages, regardless of next_page. Present only when includeTotal is true.