> ## 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. # Lister les pages TikTok > Liste les URL TikTok citées dans les réponses de l’IA, classées par nombre de citations. Inclut les URL de profils, de vidéos, de photos et les URL non attribuées. Filtrez à l’aide de channel_key renvoyé par get_tiktok_creators. Le champ share_percent de chaque page et les totaux sont calculés sur l’ensemble des citations TikTok filtrées, y compris les URL non attribuées, même lorsque vous consultez un seul compte ou une seule page de résultats. Il s’agit du nombre de citations dans les réponses de l’IA, et non des vues ou de l’engagement sur TikTok. Aucune extraction automatisée ni requête en direct vers TikTok. Les dates de début et de fin sont incluses et correspondent à des journées en UTC. Les résultats sont mis en cache pendant cinq minutes au maximum. Le nombre de citations porte sur les réponses de l’IA suivies par Athena, et non sur les vues, les abonnés ou l’engagement sur TikTok. Les identifiants sont en minuscules ; les changements de nom de compte ne sont pas pris en compte et la propriété des comptes n’est pas vérifiée. La pagination commence à zéro, avec un maximum de 100 lignes par page. Le nombre total d’éléments pour la pagination des créateurs inclut le groupe non attribué lorsqu’il existe ; totals.channels l’exclut. Les chaînes d’URL des pages conservent la clé de regroupement de Sources et peuvent omettre le schéma. Les variantes de paramètres de requête ne différant que par le suivi et les fragments de texte sont regroupés comme dans Sources. ## OpenAPI ````yaml fr/api-reference/openapi.json post /api/v1/sources/tiktok-pages openapi: 3.1.0 info: title: API AthenaHQ description: >- L’API AthenaHQ permet de gérer vos sites et prompts par programme pour l’optimisation de contenu par IA. version: 1.0.0 contact: email: support@athenahq.ai servers: - url: https://api.athenahq.ai description: Serveur de production security: - apiKey: [] tags: - name: Basics description: Opérations API principales pour gérer sites et prompts - name: Metrics description: Points de terminaison de métriques et analyses de visibilité IA - name: Billing description: Points de facturation et crédits pour gérer la consommation - name: Team Management description: Points de terminaison de gestion des membres et invitations - name: Groups description: Points de terminaison de gestion des groupes de sites - name: Content description: >- Points de terminaison Content Hub : onglets, URL suivies et détail des prompts par URL. - name: Pitch Workspace description: >- Points de terminaison des rapports Pitch Workspace : exécutions à l’échelle de l’organisation avec concurrents, prompts, attributs et métriques agrégées. - name: Knowledge Base description: >- Endpoints de lecture de la base de connaissances de la marque — faits approuvés et piliers qui les organisent. paths: /api/v1/sources/tiktok-pages: post: tags: - Sources summary: Lister les pages TikTok description: >- Liste les URL TikTok citées dans les réponses de l’IA, classées par nombre de citations. Inclut les URL de profils, de vidéos, de photos et les URL non attribuées. Filtrez à l’aide de channel_key renvoyé par get_tiktok_creators. Le champ share_percent de chaque page et les totaux sont calculés sur l’ensemble des citations TikTok filtrées, y compris les URL non attribuées, même lorsque vous consultez un seul compte ou une seule page de résultats. Il s’agit du nombre de citations dans les réponses de l’IA, et non des vues ou de l’engagement sur TikTok. Aucune extraction automatisée ni requête en direct vers TikTok. Les dates de début et de fin sont incluses et correspondent à des journées en UTC. Les résultats sont mis en cache pendant cinq minutes au maximum. Le nombre de citations porte sur les réponses de l’IA suivies par Athena, et non sur les vues, les abonnés ou l’engagement sur TikTok. Les identifiants sont en minuscules ; les changements de nom de compte ne sont pas pris en compte et la propriété des comptes n’est pas vérifiée. La pagination commence à zéro, avec un maximum de 100 lignes par page. Le nombre total d’éléments pour la pagination des créateurs inclut le groupe non attribué lorsqu’il existe ; totals.channels l’exclut. Les chaînes d’URL des pages conservent la clé de regroupement de Sources et peuvent omettre le schéma. Les variantes de paramètres de requête ne différant que par le suivi et les fragments de texte sont regroupés comme dans Sources. 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: Date de début au format YYYY-MM-DD, incluse (UTC). schedule_id: description: >- Une seule programmation : "default" ou l’UUID d’une programmation personnalisée ou archivée. Omettez ce paramètre pour utiliser la programmation par défaut, qui inclut tout l’historique antérieur à la transition ainsi que les exécutions ponctuelles. L’ancien jeton "manual" est accepté comme alias de "default". Les programmations ne peuvent pas être combinées. 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: >- Date de fin au format YYYY-MM-DD, incluse (UTC). Par défaut : aujourd’hui. 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: >- Modèles d’IA à inclure, sous forme de tableau même pour un seul modèle — par exemple ["chatgpt", "perplexity"]. Omettez ce paramètre pour inclure tous les modèles. 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 des requêtes à utiliser comme filtre, sous forme de tableau même pour un seul identifiant. Omettez ce paramètre pour inclure tous les prompts. 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 des localisations à utiliser comme filtre, sous forme de tableau même pour un seul identifiant. La chaîne littérale "no-location" sélectionne les réponses générées sans localisation. Omettez ce paramètre pour inclure toutes les localisations. 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 des personas à inclure dans le filtre, sous forme de tableau même pour un seul identifiant. Omettez ce paramètre pour inclure tous les personas. 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: >- Chaînes d’identifiants cibles à inclure dans le filtre, sous forme de tableau même pour une seule valeur. La chaîne littérale "no-identifier" sélectionne les réponses sans identifiant cible. Omettez ce paramètre pour tout inclure. type: array items: anyOf: - type: string - type: string const: no-identifier variation_filter: description: >- Lignes de requêtes à inclure, sous forme de tableau : "prompt" pour les requêtes de base, "variation" pour les variantes générées, ou les deux. Omettez ce paramètre pour inclure les deux. type: array items: type: string enum: - variation - prompt prompt_tags: description: >- UUID des étiquettes de requêtes obtenus via 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: >- Mode de combinaison de prompt_tags : "is_any_of" sélectionne les requêtes portant au moins une des étiquettes de la liste, tandis que "has_all_of" sélectionne uniquement celles qui portent toutes les étiquettes de la liste. type: string enum: - is_any_of - has_all_of prompt_status: description: >- Filtrez les prompts par statut de suivi : "active" ou "paused". Omettez ce paramètre pour inclure les deux statuts. type: string enum: - active - paused prompt_type: description: >- Filtrez les prompts par type : "branded" (mention de la marque) ou "non_branded". Omettez ce paramètre pour inclure les deux types. type: string enum: - branded - non_branded required: - start_date additionalProperties: false page_num: default: 0 description: Numéro de page, à partir de zéro. 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: >- Clé de groupe obtenue via get_tiktok_creators, y compris unattributed ; omettez ce paramètre pour inclure toutes les pages citées. 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: Succès 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: >- Clé du groupe d’identifiants, dérivée des URL ; à utiliser avec get_tiktok_pages. Le groupe non attribué a pour clé 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: >- Identifiants attribués, à l’exclusion du groupe non attribué. unattributed_citations: type: number required: - citations - channels - unattributed_citations additionalProperties: false notice: type: string required: - pages - pagination - totals additionalProperties: false '400': description: Requête incorrecte — échec de la validation content: application/json: schema: type: object properties: error: type: string required: - error '401': description: Non authentifié content: application/json: schema: type: object properties: error: type: string required: - error '403': description: Accès interdit content: application/json: schema: type: object properties: error: type: string required: - error '404': description: Introuvable content: application/json: schema: type: object properties: error: type: string required: - error '409': description: Conflit content: application/json: schema: type: object properties: error: type: string required: - error '429': description: Limite de requêtes atteinte content: application/json: schema: type: object properties: error: type: string required: - error '500': description: Erreur interne 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: >- Clé API d’authentification. Créez-en une [ici](https://app.athenahq.ai/organization?tab=api). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.