> ## Documentation Index
> Fetch the complete documentation index at: https://chainpatrol.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener tendencia del tiempo de takedown

> Get the median time from takedown start to completion bucketed by the month a takedown completed, over a trailing window of whole months, together with the month-over-month change. Returns one series per requested asset type, or a single pooled series. 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.

## Descripción general

Obtén la mediana del tiempo de **takedown** (solicitud de baja de contenido fraudulento) para cada mes de una ventana de los últimos meses, junto con el cambio
respecto al mes anterior. Los meses se agrupan según cuándo se completó el takedown.

```bash theme={null}
curl --request POST \
  --url https://app.chainpatrol.io/api/v2/metrics/takedown-time/trend \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
    "slug": "your-org",
    "months": 6,
    "assetTypes": ["URL", "TWITTER"]
  }'
```

## Cuerpo de la solicitud

| Campo | Tipo | Obligatorio | Valor predeterminado | Descripción |
| - | - | - | - | - |
| `slug` | `string` | ✅ Sí | - | Slug de la organización. |
| `months` | `number` | ❌ No | `12` | Tamaño de la ventana en meses completos, de 2 a 36, contando el mes actual. |
| `assetTypes` | `AssetType[]` | ❌ No | - | Hasta 5 tipos de **asset** (activo digital: URL, dirección, perfil, app, etc.), con una serie para cada uno. Omítelo para obtener una sola serie que agrupa todos los tipos de asset. |
| `brandIds` | `number[]` | ❌ No | - | Solo assets que pertenecen a estas marcas. |
| `brandType` | `string` | ❌ No | - | Solo marcas de este tipo: `INDIVIDUAL`, `ORGANIZATION` o `PRODUCT`. |
| `blockLabel` | `string` | ❌ No | - | Solo assets bloqueados con esta etiqueta de revisión, como `Brand Impersonation`. |
| `countryCodes` | `string[]` | ❌ No | - | Solo assets escaneados desde estos países (códigos ISO 3166-1 alpha-2). |

La serie agrupada deja fuera las direcciones cripto (`ADDRESS`), y `excludedAssetTypes`
así lo indica. Envía `ADDRESS` en `assetTypes` para obtener su propia serie. Consulta
[Obtener tiempo de takedown](https://chainpatrol.com/docs/es/external-api/metrics-takedown-time.md) para saber por qué.

## Cómo leer la respuesta

* `periods` lista todos los meses de la ventana en formato `yyyy-MM`, del más antiguo al más reciente.
* Cada serie tiene un punto por mes. Un mes sin takedowns completados tiene una
  mediana `null` y un `count` de 0. La serie agrupada tiene `assetType: null`.
* `change` compara el último mes que tuvo takedowns completados con el anterior,
  omitiendo los meses vacíos. Un `percentChange` negativo significa que los takedowns fueron más rápidos,
  y `direction` lo interpreta por ti como `improved`, `worsened` o `unchanged`. Ambos son
  `null` cuando no hay un mes anterior con el cual comparar.


## OpenAPI

````yaml POST /metrics/takedown-time/trend
openapi: 3.0.3
info:
  title: ChainPatrol External API - OpenAPI 3.0
  description: ChainPatrol External API documentation
  version: 2.0.0
servers:
  - url: https://app.chainpatrol.io/api/v2
security: []
tags:
  - name: asset
  - name: report
  - name: dark-web
externalDocs:
  url: https://chainpatrol.com/docs
paths:
  /metrics/takedown-time/trend:
    post:
      tags:
        - metrics
      summary: Get organization time-to-takedown trends
      description: >-
        Get the median time from takedown start to completion bucketed by the
        month a takedown completed, over a trailing window of whole months,
        together with the month-over-month change. Returns one series per
        requested asset type, or a single pooled series. 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.
      operationId: metricsTakedownTimeTrend
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                slug:
                  type: string
                  minLength: 1
                  description: Organization slug
                months:
                  type: integer
                  minimum: 2
                  maximum: 36
                  default: 12
                  description: >-
                    Size of the trailing window in whole months, including the
                    current month
                assetTypes:
                  type: array
                  items:
                    type: string
                    enum:
                      - 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
                  maxItems: 5
                  description: >-
                    Break the trend down by these asset types, one series each.
                    Omit for a single pooled series. 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.
                blockLabel:
                  type: string
                  description: >-
                    Only include assets blocked with this review label, e.g.
                    "Brand Impersonation", "Employee Impersonation" or
                    "Targeting Org Users"
                brandType:
                  type: string
                  enum:
                    - INDIVIDUAL
                    - ORGANIZATION
                    - PRODUCT
                  description: Only include assets belonging to brands of this type
                countryCodes:
                  type: array
                  items:
                    type: string
                    minLength: 2
                    maxLength: 2
                  description: >-
                    Only include assets scanned from these ISO 3166-1 alpha-2
                    countries
                brandIds:
                  type: array
                  items:
                    type: integer
                    minimum: 0
                    exclusiveMinimum: true
                  description: Only include assets belonging to these brands
              required:
                - slug
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  months:
                    type: number
                    description: Size of the trailing window that was used
                  periods:
                    type: array
                    items:
                      type: string
                    description: Every yyyy-MM key in the window, oldest first
                  series:
                    type: array
                    items:
                      type: object
                      properties:
                        assetType:
                          type: string
                          nullable: true
                          enum:
                            - 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
                            - null
                          description: >-
                            Null for the series pooled across every asset type
                            but `excludedAssetTypes`
                        points:
                          type: array
                          items:
                            type: object
                            properties:
                              period:
                                type: string
                                description: >-
                                  Month the takedowns completed in, as a yyyy-MM
                                  key
                              medianTakedownMinutes:
                                type: number
                                nullable: true
                                description: Null when no takedowns completed in this month
                              medianTakedownHours:
                                type: number
                                nullable: true
                              medianTakedownDays:
                                type: number
                                nullable: true
                              count:
                                type: number
                                description: >-
                                  Number of completed takedowns behind the
                                  median
                            required:
                              - period
                              - medianTakedownMinutes
                              - medianTakedownHours
                              - medianTakedownDays
                              - count
                          description: >-
                            One point per month in the window, oldest first.
                            Months with no completed takedowns carry a null
                            median
                        change:
                          type: object
                          properties:
                            latest:
                              type: object
                              nullable: true
                              properties:
                                period:
                                  type: string
                                  description: >-
                                    Month the takedowns completed in, as a
                                    yyyy-MM key
                                medianTakedownMinutes:
                                  type: number
                                  nullable: true
                                  description: >-
                                    Null when no takedowns completed in this
                                    month
                                medianTakedownHours:
                                  type: number
                                  nullable: true
                                medianTakedownDays:
                                  type: number
                                  nullable: true
                                count:
                                  type: number
                                  description: >-
                                    Number of completed takedowns behind the
                                    median
                              required:
                                - period
                                - medianTakedownMinutes
                                - medianTakedownHours
                                - medianTakedownDays
                                - count
                              description: >-
                                Most recent month in the window that had
                                completed takedowns
                            previous:
                              type: object
                              nullable: true
                              properties:
                                period:
                                  type: string
                                  description: >-
                                    Month the takedowns completed in, as a
                                    yyyy-MM key
                                medianTakedownMinutes:
                                  type: number
                                  nullable: true
                                  description: >-
                                    Null when no takedowns completed in this
                                    month
                                medianTakedownHours:
                                  type: number
                                  nullable: true
                                medianTakedownDays:
                                  type: number
                                  nullable: true
                                count:
                                  type: number
                                  description: >-
                                    Number of completed takedowns behind the
                                    median
                              required:
                                - period
                                - medianTakedownMinutes
                                - medianTakedownHours
                                - medianTakedownDays
                                - count
                              description: >-
                                Month with completed takedowns immediately
                                before `latest`, skipping empty months
                            percentChange:
                              type: number
                              nullable: true
                              description: >-
                                Change in the median from `previous` to
                                `latest`, as a percentage. Negative means
                                takedowns got faster. Null when there is no
                                comparable earlier month
                            direction:
                              type: string
                              nullable: true
                              enum:
                                - improved
                                - worsened
                                - unchanged
                                - null
                              description: >-
                                Sign of `percentChange`, read as
                                lower-is-better. Null when it is null
                          required:
                            - latest
                            - previous
                            - percentChange
                            - direction
                          description: Month-over-month comparison for this series
                      required:
                        - assetType
                        - points
                        - change
                    description: >-
                      One series per requested asset type, in the order
                      requested, or a single pooled series when no asset types
                      were given
                  excludedAssetTypes:
                    type: array
                    items:
                      type: string
                      enum:
                        - 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
                    description: >-
                      Asset types left out of this result because no asset-type
                      filter was given. Empty when the result covers exactly the
                      asset types requested
                required:
                  - months
                  - periods
                  - series
                  - excludedAssetTypes
        '400':
          description: Invalid input data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.BAD_REQUEST'
        '401':
          description: Authorization not provided
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.UNAUTHORIZED'
        '403':
          description: Insufficient access
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.FORBIDDEN'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.INTERNAL_SERVER_ERROR'
      security:
        - ApiKey: []
components:
  schemas:
    error.BAD_REQUEST:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Invalid input data
        code:
          type: string
          description: The error code
          example: BAD_REQUEST
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Invalid input data error (400)
      description: The error information
      example:
        code: BAD_REQUEST
        message: Invalid input data
        issues: []
    error.UNAUTHORIZED:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Authorization not provided
        code:
          type: string
          description: The error code
          example: UNAUTHORIZED
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Authorization not provided error (401)
      description: The error information
      example:
        code: UNAUTHORIZED
        message: Authorization not provided
        issues: []
    error.FORBIDDEN:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Insufficient access
        code:
          type: string
          description: The error code
          example: FORBIDDEN
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Insufficient access error (403)
      description: The error information
      example:
        code: FORBIDDEN
        message: Insufficient access
        issues: []
    error.INTERNAL_SERVER_ERROR:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Internal server error
        code:
          type: string
          description: The error code
          example: INTERNAL_SERVER_ERROR
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Internal server error error (500)
      description: The error information
      example:
        code: INTERNAL_SERVER_ERROR
        message: Internal server error
        issues: []
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-API-KEY
      description: >-
        Your API key. This is required by most endpoints to access our API
        programatically. Reach out to us at
        [support@chainpatrol.io](mailto:support@chainpatrol.io?subject=Re:%20API%20Key%20for%20SDK&body=Company:%20%0AName:%20%0APurpose:%20)
        to get an API key for your use.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.