> ## 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 creadores de TikTok > Lista los nombres de usuario de TikTok citados en respuestas de IA, ordenados por número de citas y con las URL sin atribuir al final. Incluye perfiles, vídeos y fotos de los hosts tiktok.com, www, m, vm y vt. Los nombres de usuario se obtienen de las URL citadas, no de identidades de cuentas verificadas; no se resuelven los enlaces cortos. Los porcentajes y los totales de citas abarcan todas las citas de TikTok filtradas, incluidas las URL sin atribuir, independientemente de la paginación. Usa get_tiktok_pages con channel_key para ver el desglose. 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-creators 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-creators: post: tags: - Sources summary: Listar creadores de TikTok description: >- Lista los nombres de usuario de TikTok citados en respuestas de IA, ordenados por número de citas y con las URL sin atribuir al final. Incluye perfiles, vídeos y fotos de los hosts tiktok.com, www, m, vm y vt. Los nombres de usuario se obtienen de las URL citadas, no de identidades de cuentas verificadas; no se resuelven los enlaces cortos. Los porcentajes y los totales de citas abarcan todas las citas de TikTok filtradas, incluidas las URL sin atribuir, independientemente de la paginación. Usa get_tiktok_pages con channel_key para ver el desglose. 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.tiktokCreators 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 aunque solo haya un identificador. Omite este parámetro 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 aunque solo haya un valor. La cadena literal "no-identifier" selecciona las respuestas sin identificador de destino. Omite este parámetro 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. Omite este parámetro 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 las consultas con cualquiera de las etiquetas indicadas; "has_all_of", solo las que contienen 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". Omite este parámetro para incluir ambos estados. type: string enum: - active - paused prompt_type: description: >- Filtra las consultas por tipo: "branded" (de marca, menciona la marca) o "non_branded". Omite este parámetro para incluir ambos tipos. 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 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: creators: type: array items: 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' citations: type: number share_percent: type: number page_count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - channel_key - handle - url - citations - share_percent - page_count 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: - creators - 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.