> ## 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. # Listar páginas de TikTok > Lista las URL de TikTok citadas en respuestas de IA, ordenadas por número de citas. Incluye URL de perfiles, vídeos y fotos, así como URL sin atribuir. Filtra por channel_key de get_tiktok_creators. El valor share_percent de cada página y los totales se calculan sobre todas las citas de TikTok filtradas, incluidas las URL sin atribuir, incluso al consultar el desglose de un solo canal o al paginar. Son recuentos de citas en respuestas de IA, no de visualizaciones ni interacciones de TikTok. No se realiza scraping ni se envían solicitudes en tiempo real a TikTok. Las fechas corresponden a días completos en UTC, con ambos extremos incluidos. Los resultados se almacenan en caché durante un máximo de cinco minutos. Los recuentos de citas miden las respuestas de IA rastreadas por Athena, no las visualizaciones, los seguidores ni las interacciones de TikTok. Los nombres de usuario están en minúsculas; no se vinculan los nombres anteriores y actuales de una misma cuenta ni se verifica su titularidad. La paginación empieza en cero y admite un máximo de 100 filas por página. El total de la paginación de creadores incluye un grupo sin atribuir cuando existe; totals.channels lo excluye. Las cadenas de URL de las páginas conservan la clave de agrupación de Fuentes y pueden omitir el esquema. Las variantes de los parámetros de consulta que difieren solo en el seguimiento y los fragmentos de texto se agrupan igual que en Fuentes. ## OpenAPI ````yaml es/api-reference/openapi.json post /api/v1/sources/tiktok-pages 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/sources/tiktok-pages: post: tags: - Sources summary: Listar páginas de TikTok description: >- Lista las URL de TikTok citadas en respuestas de IA, ordenadas por número de citas. Incluye URL de perfiles, vídeos y fotos, así como URL sin atribuir. Filtra por channel_key de get_tiktok_creators. El valor share_percent de cada página y los totales se calculan sobre todas las citas de TikTok filtradas, incluidas las URL sin atribuir, incluso al consultar el desglose de un solo canal o al paginar. Son recuentos de citas en respuestas de IA, no de visualizaciones ni interacciones de TikTok. No se realiza scraping ni se envían solicitudes en tiempo real a TikTok. Las fechas corresponden a días completos en UTC, con ambos extremos incluidos. Los resultados se almacenan en caché durante un máximo de cinco minutos. Los recuentos de citas miden las respuestas de IA rastreadas por Athena, no las visualizaciones, los seguidores ni las interacciones de TikTok. Los nombres de usuario están en minúsculas; no se vinculan los nombres anteriores y actuales de una misma cuenta ni se verifica su titularidad. La paginación empieza en cero y admite un máximo de 100 filas por página. El total de la paginación de creadores incluye un grupo sin atribuir cuando existe; totals.channels lo excluye. Las cadenas de URL de las páginas conservan la clave de agrupación de Fuentes y pueden omitir el esquema. Las variantes de los parámetros de consulta que difieren solo en el seguimiento y los fragmentos de texto se agrupan igual que en Fuentes. operationId: sources.tiktokPages requestBody: required: true content: application/json: schema: type: object properties: website_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ filters: type: object properties: start_date: type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ description: Primer día, en formato YYYY-MM-DD, incluido (UTC). schedule_id: description: >- Una programación: "default" o el UUID de una programación personalizada o archivada. Omite este parámetro para usar la predeterminada, que incluye todo el historial anterior a la transición y las ejecuciones ad hoc. El token obsoleto "manual" se acepta como alias de "default". No se pueden combinar programaciones. anyOf: - type: string enum: - default - manual - type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ end_date: description: >- Último día, en formato YYYY-MM-DD, incluido (UTC). Por defecto, se usa el día de hoy. type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ models: description: >- Modelos de IA que se incluirán, en un array aunque solo haya uno; p. ej., ["chatgpt", "perplexity"]. Omite este parámetro para incluir todos los modelos. type: array items: type: string enum: - chatgpt - perplexity - gemini - google_ai_overview - copilot - claude - ai_mode - grok - deepseek - meta_ai - mistral prompt_ids: description: >- UUID de las consultas por las que filtrar, en un array aunque solo haya un identificador. Omite este parámetro para incluir todas las consultas. type: array items: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ location_ids: description: >- UUID de las ubicaciones por las que filtrar, en un array aunque solo haya un identificador. La cadena literal "no-location" selecciona las respuestas generadas sin ubicación. Omite este parámetro para incluir todas las ubicaciones. type: array items: anyOf: - type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ - type: string const: no-location persona_ids: description: >- UUID de los perfiles por los que filtrar, en un array incluso si solo hay un id. Omítelo para incluir todos los perfiles. type: array items: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ target_identifiers: description: >- Cadenas de identificadores de destino por las que filtrar, en un array incluso si solo hay un valor. La cadena literal "no-identifier" selecciona respuestas sin identificador de destino. Omítelo para incluir todas las respuestas. type: array items: anyOf: - type: string - type: string const: no-identifier variation_filter: description: >- Filas de consultas que se incluirán, en un array: "prompt" para las consultas base, "variation" para las variaciones generadas, o ambos valores. Omítelo para incluir ambos tipos. type: array items: type: string enum: - variation - prompt prompt_tags: description: >- UUID de las etiquetas de consultas obtenidos de get_prompt_tags. type: array items: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ prompt_tags_operator: description: >- Cómo se combinan los valores de prompt_tags: "is_any_of" selecciona consultas con cualquiera de las etiquetas indicadas; "has_all_of", solo las que tengan todas las etiquetas indicadas. type: string enum: - is_any_of - has_all_of prompt_status: description: >- Filtra las consultas por estado de seguimiento: "active" o "paused". Omítelo para incluir ambos. type: string enum: - active - paused prompt_type: description: >- Filtra las consultas por tipo: "branded" (de marca, menciona la marca) o "non_branded". Omítelo para incluir ambos. type: string enum: - branded - non_branded required: - start_date additionalProperties: false page_num: default: 0 description: Número de página, empezando por cero. type: integer minimum: 0 maximum: 1000000 page_size: type: integer minimum: 1 maximum: 100 default: 30 channel_key: type: string minLength: 1 maxLength: 500 description: >- Clave de grupo de get_tiktok_creators, incluido unattributed; omítela para incluir todas las páginas citadas. required: - website_id - filters example: website_id: 123e4567-e89b-42d3-a456-426614174000 filters: start_date: '2026-10-01' end_date: '2026-10-31' page_num: 0 page_size: 30 responses: '200': description: Éxito content: application/json: schema: type: object properties: pages: type: array items: type: object properties: url: type: string channel: type: object properties: channel_key: type: string description: >- Clave de agrupación por nombre de usuario obtenida de la URL; úsala con get_tiktok_pages. El grupo sin atribuir tiene la clave unattributed. handle: type: - string - 'null' url: type: - string - 'null' required: - channel_key - handle - url additionalProperties: false citations: type: number share_percent: type: number required: - url - channel - citations - share_percent additionalProperties: false pagination: type: object properties: page_num: type: integer minimum: -9007199254740991 maximum: 9007199254740991 page_size: type: integer minimum: -9007199254740991 maximum: 9007199254740991 total: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - page_num - page_size - total additionalProperties: false totals: type: object properties: citations: type: number channels: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Nombres de usuario atribuidos, sin incluir el grupo sin atribuir. unattributed_citations: type: number required: - citations - channels - unattributed_citations additionalProperties: false notice: type: string required: - pages - pagination - totals additionalProperties: false '400': description: Solicitud incorrecta — error de validación 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 '409': description: Conflicto 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: - apiKey: [] 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.