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

# Seguir URLs externas

> Registra páginas existentes o URL de terceros como elementos monitorizados del centro de contenidos para atribuirles citas y menciones. Crea filas externas a partir de URL, sin generación ni coste de créditos. La monitorización empieza inmediatamente: la URL normalizada es la clave de cruce de citas y métricas, así que las páginas citadas en respuestas monitorizadas acumulan métricas sin publicar nada. Úsalo para artículos invitados, publicaciones de socios o páginas no generadas por Athena. Es idempotente por URL: si ya existe en el sitio, con cualquier tipo de contenido, no se duplica y aparece en skipped con content_id y tipo existentes. Comprueba el tipo antes de llamadas destructivas, pues puede ser contenido propio generado que comparte URL. Se crean filas sin texto de página, innecesario para citas; el cuerpo se puede completar después en la aplicación. URL duplicadas en una llamada, incluidas variantes con parámetros de seguimiento, se reducen a una fila y prevalece la primera. sheet_id opcional asigna filas a una pestaña; las de tipo vista se resuelven al repositorio principal (null), indicado por fila. fields opcionales por URL establecen columnas propias del cliente en la fila creada, por su nombre visible en la pestaña de destino: text, number, date, checkbox, link y multi_select; se crean las opciones multiselección desconocidas. Una columna desconocida o valor incompatible rechaza toda la llamada sin monitorizar nada; las URL omitidas conservan sus valores. Cada entrada creada u omitida incluye destination_name y content_hub_url. Compártelos con el usuario junto con los recuentos creados y omitidos. El enlace abre el elemento con su sitio y destino seleccionados. Omitir sheet_id usa el repositorio compartido, independientemente de la pestaña del navegador. Una URL omitida conserva su pestaña, aunque se solicite otra.



## OpenAPI

````yaml es/api-reference/openapi.json post /api/v1/content/track
openapi: 3.1.0
info:
  title: API de AthenaHQ
  description: >-
    La API de AthenaHQ ofrece acceso programático para gestionar tus sitios web
    y consultas para optimizar el contenido con IA.
  version: 1.0.0
  contact:
    email: support@athenahq.ai
servers:
  - url: https://api.athenahq.ai
    description: Servidor de producción
security:
  - apiKey: []
tags:
  - name: Basics
    description: Operaciones principales de la API para gestionar sitios web y consultas
  - name: Metrics
    description: Endpoints de métricas y análisis para monitorizar la visibilidad en IA
  - name: Billing
    description: Endpoints de facturación y créditos para gestionar el uso
  - name: Team Management
    description: Endpoints para gestionar miembros del equipo e invitaciones
  - name: Groups
    description: Endpoints para gestionar grupos de sitios web
  - name: Content
    description: >-
      Endpoints para acceder a los datos del centro de contenidos: pestañas, URL
      monitorizadas y desglose de consultas por URL.
  - name: Pitch Workspace
    description: >-
      Endpoints para acceder a los informes del espacio de propuestas:
      ejecuciones de propuestas con alcance de organización, con competidores,
      consultas, atributos y métricas agregadas.
  - name: Knowledge Base
    description: >-
      Endpoints para leer la base de conocimientos de la marca: datos aprobados
      sobre la marca y los pilares que los organizan.
paths:
  /api/v1/content/track:
    post:
      tags:
        - Content
      summary: Seguir URLs externas
      description: >-
        Registra páginas existentes o URL de terceros como elementos
        monitorizados del centro de contenidos para atribuirles citas y
        menciones. Crea filas externas a partir de URL, sin generación ni coste
        de créditos. La monitorización empieza inmediatamente: la URL
        normalizada es la clave de cruce de citas y métricas, así que las
        páginas citadas en respuestas monitorizadas acumulan métricas sin
        publicar nada. Úsalo para artículos invitados, publicaciones de socios o
        páginas no generadas por Athena. Es idempotente por URL: si ya existe en
        el sitio, con cualquier tipo de contenido, no se duplica y aparece en
        skipped con content_id y tipo existentes. Comprueba el tipo antes de
        llamadas destructivas, pues puede ser contenido propio generado que
        comparte URL. Se crean filas sin texto de página, innecesario para
        citas; el cuerpo se puede completar después en la aplicación. URL
        duplicadas en una llamada, incluidas variantes con parámetros de
        seguimiento, se reducen a una fila y prevalece la primera. sheet_id
        opcional asigna filas a una pestaña; las de tipo vista se resuelven al
        repositorio principal (null), indicado por fila. fields opcionales por
        URL establecen columnas propias del cliente en la fila creada, por su
        nombre visible en la pestaña de destino: text, number, date, checkbox,
        link y multi_select; se crean las opciones multiselección desconocidas.
        Una columna desconocida o valor incompatible rechaza toda la llamada sin
        monitorizar nada; las URL omitidas conservan sus valores. Cada entrada
        creada u omitida incluye destination_name y content_hub_url. Compártelos
        con el usuario junto con los recuentos creados y omitidos. El enlace
        abre el elemento con su sitio y destino seleccionados. Omitir sheet_id
        usa el repositorio compartido, independientemente de la pestaña del
        navegador. Una URL omitida conserva su pestaña, aunque se solicite otra.
      operationId: content.track_urls
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                website_id:
                  type: string
                  description: Sitio web en el que se seguirán las URLs.
                urls:
                  type: array
                  minItems: 1
                  maxItems: 500
                  description: >-
                    Páginas que se monitorizarán. Se admite una ruta sin
                    protocolo como acme.com/blog/post; el protocolo se elimina
                    al guardar.
                  items:
                    type: object
                    properties:
                      url:
                        type: string
                        minLength: 1
                        maxLength: 2048
                      title:
                        type: string
                        minLength: 1
                        maxLength: 500
                        description: >-
                          Título visible opcional. Si se omite, se deduce del
                          slug de la URL.
                      fields:
                        type: array
                        maxItems: 50
                        description: >-
                          Valores opcionales de las columnas del centro de
                          contenidos creadas por el cliente en la pestaña de
                          destino; se escriben en la fila creada. No se aplican
                          a URL omitidas. Cada columna puede aparecer una vez
                          por URL.
                        items:
                          type: object
                          properties:
                            column:
                              type: string
                              minLength: 1
                              maxLength: 200
                              description: >-
                                Nombre de la columna tal como aparece en la
                                pestaña (sin distinguir mayúsculas de
                                minúsculas). Tipos editables: text, number,
                                date, checkbox, link, multi_select. Las columnas
                                generadas (Ask Athena, approval, OG image, etc.)
                                se rechazan.
                            value:
                              description: >-
                                Value in the column's type: string for text;
                                http(s) URL string for link; number or numeric
                                string for number; ISO 8601 date string
                                (2026-09-01 or 2026-09-01T10:00:00Z, other
                                formats are rejected; a date-only value is
                                stored as UTC midnight) for date; boolean (or
                                true/false, yes/no) for checkbox; array of
                                option labels, or a comma-separated string, for
                                multi_select (50 labels at most either way).
                                Unknown multi-select options are created;
                                existing ones match case-insensitively.
                              oneOf:
                                - type: string
                                  maxLength: 10000
                                - type: number
                                - type: boolean
                                - type: array
                                  maxItems: 50
                                  items:
                                    type: string
                                    maxLength: 200
                          required:
                            - column
                            - value
                    required:
                      - url
                sheet_id:
                  type: string
                  nullable: true
                  description: >-
                    Pestaña del centro de contenidos a la que se asignarán las
                    filas nuevas. Las pestañas de tipo vista se resuelven al
                    repositorio principal (null).
              required:
                - website_id
                - urls
      responses:
        '201':
          description: >-
            Creado. También se devuelve si todas las URL ya estaban
            monitorizadas (éxito idempotente con created_count 0).
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  created_count:
                    type: number
                  skipped_count:
                    type: number
                  created:
                    type: array
                    items:
                      type: object
                      properties:
                        content_id:
                          type: string
                        url:
                          type: string
                          description: >-
                            URL almacenada sin protocolo, en formato de
                            presentación.
                        destination_name:
                          type: string
                          description: >-
                            Nombre de la pestaña de destino real, o Repositorio
                            compartido si no existe una vista de este
                            repositorio.
                        content_hub_url:
                          type: string
                          format: uri
                          description: >-
                            Abre el elemento en el centro de contenidos con su
                            sitio web y pestaña de destino seleccionados.
                        sheet_id:
                          type: string
                          nullable: true
                      required:
                        - content_id
                        - url
                        - sheet_id
                        - destination_name
                        - content_hub_url
                  skipped:
                    type: array
                    items:
                      type: object
                      properties:
                        content_id:
                          type: string
                          description: >-
                            Fila existente a la que se ha resuelto esta URL de
                            entrada.
                        url:
                          type: string
                          description: URL de entrada depurada que se ha omitido.
                        destination_name:
                          type: string
                          description: >-
                            Destino real de la fila existente, que puede diferir
                            de la pestaña solicitada.
                        content_hub_url:
                          type: string
                          format: uri
                          description: >-
                            Abre el elemento existente en su ubicación actual
                            del centro de contenidos. Las filas omitidas no se
                            mueven.
                        type:
                          type: string
                          description: >-
                            Tipo de contenido de la fila existente.
                            external/imported indica que la URL ya estaba
                            monitorizada; otro valor (draft, snipe, etc.) indica
                            colisión con contenido propio generado que comparte
                            la clave de cruce. Compruébalo antes de encadenar
                            llamadas destructivas.
                        sheet_id:
                          type: string
                          nullable: true
                      required:
                        - content_id
                        - url
                        - type
                        - sheet_id
                        - destination_name
                        - content_hub_url
                required:
                  - success
                  - created_count
                  - skipped_count
                  - created
                  - skipped
        '400':
          description: >-
            Solicitud incorrecta: ha fallado la validación (URL no válida en el
            lote, sheet_id ajeno a este sitio web, columna desconocida o valor
            incompatible con su tipo; no se escribe nada)
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '401':
          description: Sin autenticar
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '403':
          description: Acceso denegado
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '404':
          description: No encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '429':
          description: Límite de solicitudes alcanzado
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '500':
          description: Error interno
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Clave de API para autenticarse. Puedes crear una
        [aquí](https://app.athenahq.ai/organization?tab=api).

````

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