> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/fr/developpeurs/api.md). # API Insights L’API Insights d’AirOps : une API de suivi AEO et des citations IA avec accès programmatique au taux de mentions, à la part de voix, aux citations et aux performances des pages, pour des tableaux de bord personnalisés, l’ETL et le reporting. L'API Insights est l'API d'optimisation des moteurs de réponse (AEO) et de suivi des citations IA d'AirOps, vous donnant un accès programmatique aux mêmes données que celles visibles dans votre tableau de bord Insights — taux de mention, citations, part de voix, performances des pages, et plus encore. Utilisez-la pour créer des tableaux de bord personnalisés, automatiser les rapports ou acheminer les données AEO vers votre entrepôt de données avec vos autres métriques marketing. Tous les endpoints Insights se trouvent sous `/public_api/brand_kits` et nécessitent un Kit de marque avec AEO activé. Pour la configuration de l'authentification, voir la [Référence de l'API](https://docs.airops.com/api-reference). *** ## Modèle de données Le Kit de marque est la ressource racine. Tout le reste s'y connecte : | Ressource | Ce qu'elle contient | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Analytique** | Requêtes de métriques flexibles — taux de mention, part de voix, taux de citation, sentiment, et plus encore — ventilées par fournisseur, concurrent, sujet, pays ou date | | **Pages web** | Vos pages suivies, avec les citations AEO, Google Search Console et les métriques GA4 combinées | | **Prompts** | Questions IA suivies, avec les taux de mention/citation et les tendances | | **Citations** | URLs citées dans les réponses IA, avec un score d'influence et le sentiment | | **Concurrents** | Domaines que vous surveillez pour l'analyse concurrentielle | | **Sujets** | Catégories qui organisent vos prompts | | **Personas** | Profils d'audience utilisés pour l'analyse des prompts | *** ## Démarrage rapide ### 1. Trouvez votre Kit de marque ```bash curl -X POST https://api.airops.com/public_api/brand_kits/list \\ -H "Authorization: Bearer YOUR_API_KEY" \\ -H "Content-Type: application/json" \\ -d '{ "filters": [{ "field": "aeo_enabled", "operator": "EQ", "value": true }] }' ``` La réponse inclut l'id de votre Kit de marque `id` — utilisez-le dans tous les appels suivants. ### 2. Interrogez votre visibilité IA ```bash curl -X POST https://api.airops.com/public_api/brand_kits/{brand_kit_id}/analytics \\ -H "Authorization: Bearer YOUR_API_KEY" \\ -H "Content-Type: application/json" \\ -d '{ "metrics": ["mention_rate", "share_of_voice", "citation_rate"], "dimensions": ["date"], "grain": "weekly", "start_date": "2026-01-01", "end_date": "2026-02-18" }' ``` ### 3. Trouvez les pages qui nécessitent une attention ```bash curl -X POST https://api.airops.com/public_api/brand_kits/{brand_kit_id}/web_pages/list \\ -H "Authorization: Bearer YOUR_API_KEY" \\ -H "Content-Type: application/json" \\ -d '{ "smart_filter": "losing_ai_visibility", "per_page": 10, "sort": "-citations_count" }' ``` Trois appels et vous obtenez : votre tendance de visibilité, votre position concurrentielle et les pages qui nécessitent un travail. *** ## Endpoints ### De quel endpoint ai-je besoin ? | Je veux... | Utiliser | | ------------------------------------------------------------ | -------------------------------------- | | Obtenir mes métriques globales de visibilité IA | Analytique | | Comparer avec les concurrents dans le temps | Analytique avec `competitor` dimension | | Décomposer les performances par fournisseur IA | Analytique avec `provider` dimension | | Trouver les pages qui perdent des citations ou des positions | Pages web avec filtres intelligents | | Obtenir les données AEO + SEO + trafic par page | Pages web | | Voir quelles questions IA mentionnent ma marque | Prompts | | Voir quelles URLs sont citées | Citations | ### Analytique `POST /public_api/brand_kits/{id}/analytics` L'endpoint le plus flexible. Choisissez n'importe quelle combinaison de métriques et de dimensions pour construire la requête exacte dont vous avez besoin. **Métriques :** | Métrique | Description | | -------------------- | ------------------------------------------------------------ | | `taux_de_mention` | % des réponses IA qui mentionnent votre marque (0-100) | | `share_of_voice` | Vos mentions / (les vôtres + celles des concurrents) (0-100) | | `taux_de_citation` | % des réponses IA qui citent vos pages (0-100) | | `citation_share` | Vos citations / nombre total de citations (0-100) | | `citation_count` | Nombre absolu de citations | | `sentiment_score` | Sentiment des mentions de marque (0-100) | | `average_position` | Position moyenne dans les listes de réponses IA | | `answer_count` | Nombre total de réponses IA analysées | | `first_mention_rate` | % des réponses où vous êtes mentionné en premier (0-100) | **Dimensions** (jusqu'à 3 par requête) : `date`, `provider`, `topic`, `country`, `persona`, `domain`, `competitor`, `domain_category` **Granularité temporelle :** `quotidien` (max. 120 jours), `hebdomadaire` (max. 180 jours), `mensuel` (max. 365 jours), `total` (max. 365 jours) **Filtres :** `providers`, `topics`, `countries`, `personas`, `brand_mentioned` **Limites :** Maximum 1 000 lignes par requête. 100 par défaut. ### Pages web `POST /public_api/brand_kits/{id}/web_pages/list` Vos pages suivies combinent dans une seule réponse les données de citation, de recherche, de trafic et d'Agent Analytics : | Source | Métriques | | ------------------------- | ------------------------------------------------------------------------------------------------------------------- | | **AEO** | `citations_count`, `taux_de_citation`, `prompts_count` | | **Google Search Console** | `clicks`, `impressions`, `ctr`, `position` | | **Google Analytics 4** | `traffic`, `sessions`, `engagement`, `average_session_engagement` | | **Agent Analytics** | `user_browse` (Visites de l'agent IA), `ai_training` (Crawls d'entraînement), `ai_search` (Crawls de recherche Web) | Les champs Agent Analytics sont des compteurs filtrables et triables pour la plage de dates sélectionnée. Connectez d'abord Agent Analytics pour collecter ces données. Ces champs n'incluent pas de variantes de variation d'une période à l'autre. `total_crawls` n'est pas un champ de cet endpoint ; utilisez l'endpoint Agent Analytics ci-dessous pour ce calcul. Les espaces de travail du forfait gratuit reçoivent **402 Payment Required** depuis l'endpoint Web Pages. **Filtres intelligents** font ressortir les opportunités courantes : | Filtre | Ce qu'il trouve | | ----------------------- | ---------------------------------------------- | | `almost_page_one` | Pages classées entre la 10e et la 20e position | | `losing_clicks` | Clics en baisse avec des classements stables | | `rankings_slipping` | Position SERP en baisse sur 90 jours | | `losing_ai_visibility` | Pages perdant des citations IA | | `citation_rate_decline` | Perte d'autorité IA malgré un SEO stable | Plus de 26 champs filtrables avec opérateurs : `EQ`, `NEQ`, `GT`, `LT`, `GEQ`, `LEQ`, `CONTAINS`, `STARTS_WITH`, `IN` ### Agent Analytics `POST /public_api/brand_kits/{id}/agent_analytics/list` Renvoie le nombre quotidien de requêtes pour les pages suivies du Kit de marque après que vous [connectez Agent Analytics](/docs/fr/insights/onsite/traffic.md). Chaque ligne contient `date`, `platform`, `crawl_type`, et `count`. Les lignes sans requêtes sont omises. Fournissez `start_date` et `end_date` pour choisir une période. Vous pouvez filtrer par `platform`, `crawl_type`, ou un seul `web_page_id`, et trier par `date` ou `count` (`-count` pour les plus grands d'abord). La pagination commence par 25 lignes par défaut et prend en charge jusqu'à 100 par page. Lisez chaque page avant de calculer les totaux. | Résultat | Calcul | | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | Agent Analytics **Nombre total de crawls** | Somme `ai_search` et `ai_training` pour les moteurs suivis. | | **Visites de l'agent IA** | Somme `user_browse` pour les moteurs suivis. | | **Moteur de crawl principal** | Le moteur suivi avec le total combiné le plus élevé de `ai_search` et `ai_training` nombre. | | **Répartition par type de crawl** | Chacun des `ai_search` et `ai_training` en pourcentage de leur total combiné pour les moteurs suivis. | | **Répartition par moteur** | Regroupez par moteur suivi et additionnez les crawls d'entraînement, les crawls de recherche Web, leur total combiné et les visites de l'agent IA. | | **Activité de crawl vs. visites de l'agent IA** | Regroupez par date et type de crawl sur toutes les plateformes renvoyées, y compris `autres` requêtes. | | **Visites de l'agent IA dans le temps** | Regroupez `user_browse` par date et moteur suivi. | Les moteurs suivis pour ces calculs sont `chat_gpt`, `perplexity`, `gemini`, `google_ai_mode`, et `claude`. La réponse inclut également d'autres plateformes, comme les crawlers de recherche génériques. Pour correspondre au **Pages** de la **Nombre total de crawls** pour une page, filtrez par son `web_page_id` et additionnez toutes les lignes, y compris toutes les plateformes et tous les types de crawl. Cela diffère du total de crawl limité à l'IA du récapitulatif Agent Analytics. {% hint style="info" %} L'endpoint quotidien suit la limite de date de l'onglet Agent Analytics : une requête exactement à minuit après `end_date` peut apparaître comme une ligne datée du jour suivant. Excluez les lignes datées après `end_date` lors de la correspondance avec la table Pages. {% endhint %} ### Prompts `POST /public_api/brand_kits/{id}/prompts/list` · `GET /public_api/brand_kits/{id}/prompts/{id}` Questions IA suivies pour votre marque. Chaque prompt inclut `taux_de_mention`, `taux_de_citation`ainsi que les tendances période par période (`mention_rate_trend`, `citation_rate_trend`). Filtrer par `text`, `brand_mentioned`, `topic_id`, `prompt_volume`, `taux_de_mention`, `taux_de_citation`. Limitez les métriques à des fournisseurs, pays ou personas spécifiques à l'aide de filtres de contexte. ### Intention de réponse Les réponses de liste et de détail exposent le champ en lecture seule du prompt `intent_stage`: `awareness`, `consideration`, `evaluation`, ou `purchase`. Il s'agit de `null` lorsque la classification n'est pas disponible. Le même champ est disponible via les outils de réponse MCP. ### Citations `POST /public_api/brand_kits/{id}/citations/list` · `POST /public_api/brand_kits/{id}/citations/show` URLs citées dans les réponses IA, chacune évaluée avec un `influence_score` (0-100) qui prend en compte l'autorité du domaine, la fréquence des citations et la pertinence. Inclut `brand_sentiment` (positif/neutre/négatif) et `domain_category`. Trier par `citation_count`, `citation_share`, `taux_de_citation`, ou `influence_score`. Pour les citations et les domaines, `prompt_type` avec `EQUALS` et la valeur `brand` ou `category` décrit le prompt. `brand_mentioned` avec `EQ` et la valeur `true` ou `false` décrit si la page citante mentionne votre marque. Ces filtres peuvent être combinés : ```json { "filters": [ { "field": "prompt_type", "operator": "EQUALS", "value": "category" }, { "field": "brand_mentioned", "operator": "EQ", "value": true } ] } ``` L'ancien `brand_mentioned EQUALS brand/category` et `brand_referenced EQ true/false` les alias restent acceptés. Les nouveaux filtres explicites priment si les deux formes sont présentes. Sur l'endpoint Prompts, `brand_mentioned EQ true/false` continue de décrire le texte du prompt. Les réponses de liste et de détail des citations incluent un champ `social` lorsque des métadonnées sociales prises en charge existent. Il identifie la plateforme et contient `content` et `account` des objets avec des métadonnées, des métriques et un état de synchronisation. `social` est `null` lorsqu'aucun enregistrement social pris en charge n'existe ; `social.account` peut être `null` même lorsque du contenu est présent. Les métadonnées peuvent être incomplètes pendant la collecte en attente ou après une collecte échouée. Les métadonnées du contenu YouTube incluent également `duration_seconds`, `format`, et `sponsorship_status`. La durée peut être `null`; le format et l'état de sponsoring utilisent `unknown` lorsque l'information n'est pas disponible. ### Annonces observées `POST /public_api/aeo/brand_kits/{id}/ads/list` · `POST /public_api/aeo/brand_kits/{id}/ads/show` Interrogez les annonces ChatGPT et Google AI Mode qu'AirOps observe pour les prompts suivis du Kit de marque. Ces endpoints utilisent les mêmes données d'annonces observées que [Bibliothèque d'annonces](/docs/fr/insights/ads.md#ad-library) et ne nécessitent pas de connexion à un compte ChatGPT Ads. Elles nécessitent un accès aux données Ads du Kit de marque. | Point de terminaison | Renvoie | | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Liste** | Une ligne par fournisseur et création observée, avec les détails de l'annonceur, le titre et le corps, les apparitions, les réponses distinctes, les prompts, la fréquence et l'historique d'observation | | **Afficher** | Les détails d'une création propre à un fournisseur, ainsi que l'image et l'URL de destination, l'annonceur et l'historique d'observation | Passez le résultat de la liste `observed_creative_id` en tant que `id` et son `provider` tableau à un seul élément `providers` à l'endpoint de détails. Cela identifie une création observée sur cette plateforme, et non une ressource de votre compte publicitaire connecté. La même création peut avoir des lignes de liste distinctes pour différentes plateformes. Les listes incluent par défaut les deux fournisseurs pris en charge. Utilisez `providers: ["chat_gpt"]` ou `providers: ["google_ai_mode"]` pour en sélectionner une. Les requêtes Show par défaut utilisent ChatGPT lorsqu’aucun n’est fourni et exigent exactement un fournisseur lorsqu’il est fourni. Les filtres de liste incluent `topic_id`, `prompt_id`, et `prompt_type` (`EQUALS` avec `brand` ou `category`). L’ancien `brand_mentioned` alias prompt-type est toujours accepté. Limitez les requêtes avec `start_date`, `end_date`, `providers`, `countries`, `personas`, et `tags`. La liste prend en charge la pagination et la sélection de champs. `appearances` compte les occurrences d’annonces ; `answers` compte les réponses collectées distinctes contenant l’annonce. `frequency` est le pourcentage de réponses suivies dans le périmètre qui le contiennent. `first_seen` et `last_seen` couvrent l’historique d’observation de l’annonce, et `days_active` est l’intervalle inclusif entre eux. Le point de terminaison show ne renvoie pas les métriques fenêtrées de la liste pour les occurrences, les réponses, les prompts ou la fréquence. Ces observations n’établissent pas une couverture complète du marché, les dépenses publicitaires ni l’intention de ciblage. Les outils MCP équivalents sont [list\_aeo\_ads et get\_aeo\_ad](/docs/fr/developpeurs/tools.md#list_aeo_ads). ### Concurrents, sujets, personas `POST /public_api/brand_kits/{id}/competitors/list` · `GET .../competitors/{id}` `POST /public_api/brand_kits/{id}/topics/list` · `GET .../topics/{id}` `POST /public_api/brand_kits/{id}/personas/list` · `GET .../personas/{id}` Données de référence pour la configuration de votre Brand Kit. Utilisez ces IDs pour filtrer d’autres points de terminaison. *** ## Modèles courants ### Pagination Tous les points de terminaison de liste utilisent une pagination par décalage avec un maximum de 100 éléments par page. ```json { "page": 1, "per_page": 100 } ``` Les réponses incluent `meta.total_count` et `meta.total_pages`. Bouclez jusqu’à `page >= total_pages`. ### Filtrage Passez un `filters` tableau dans le corps de la requête : ```json { "filters": [ { "field": "citation_rate", "operator": "GT", "value": 5 }, { "field": "brand_mentioned", "operator": "EQ", "value": true } ] } ``` | Tapez | Opérateurs | | --------- | ------------------------------------- | | Texte | `EQUALS`, `CONTAINS`, `STARTS_WITH` | | Numérique | `EQ`, `NEQ`, `GT`, `LT`, `GEQ`, `LEQ` | | Ensemble | `IN` | ### Tri Passez un `sort` chaîne. Préfixez avec `-` pour un ordre décroissant : ```json { "sort": "-citation_rate" } ``` ### Sélection des champs Passez un `fields` tableau pour limiter les champs renvoyés : ```json { "fields": ["url", "citations_count", "clicks", "position"] } ``` ### Plages de dates Les points de terminaison des métriques acceptent `start_date` et `end_date` dans `AAAA-MM-JJ` format. Par défaut, il s’agit des 30 derniers jours si omis. * `end_date` doit être antérieur à aujourd’hui * Les métriques GSC et GA4 ont un décalage de 4 jours ### Disponibilité des données Chaque réponse de métrique inclut un `data_availability` objet : ```json { "data_availability": { "earliest_data_date": "2025-10-15", "latest_data_date": "2026-02-18", "requested_period_has_data": true } } ``` Vérifiez `requested_period_has_data` avant de traiter les résultats. *** ## Fournisseurs d’IA pris en charge Utilisez ces valeurs dans le `providers` filtre : | Valeur | Plateforme | | -------------------- | ------------------ | | `chat_gpt` | ChatGPT | | `gemini` | Google Gemini | | `perplexity` | Perplexity | | `google_ai_mode` | Google AI Mode | | `google_ai_overview` | Google AI Overview | | `claude` | Claude | Claude est disponible par défaut sur les espaces Enterprise. Chaque réponse Claude utilise quatre unités de facturation : quatre tâches sur un espace à tâches combinées ou quatre Answer Credits sur un espace hérité. Voir [Utilisation et facturation des Answers AEO](/docs/fr/votre-espace-de-travail/settings/billing.md#aeo-answers-usage-and-billing). *** ## Pays pris en charge AirOps accepte ces 49 codes de région. Transmettez des codes ISO 3166-1 alpha-2 dans le `countries` filtre : `AE` `AR` `AT` `AU` `BE` `BR` `CA` `CH` `CL` `CN` `CO` `CZ` `DE` `DK` `ES` `FI` `FR` `GB` `GR` `HR` `HU` `ID` `IE` `IL` `IN` `IS` `IT` `JP` `KE` `KR` `MX` `MY` `NG` `NL` `NO` `NZ` `PE` `PH` `PL` `PT` `SA` `SE` `SG` `TH` `TR` `TW` `US` `VN` `ZA` La couverture de la plateforme varie selon la région. Une région figurant dans cette liste ne garantit pas que chaque fournisseur d’IA y collecte des réponses. Par exemple, le Kenya est pris en charge pour ChatGPT, Google AI Overview, Google AI Mode et Claude ; d’autres fournisseurs peuvent ne pas être disponibles. *** ## Erreurs | Statut | Signification | | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **400** | Filtre, opérateur ou champ de tri invalide. Vérifiez `validation_errors` dans la réponse. | | **401** | Clé API manquante ou invalide. | | **402** | Le point de terminaison nécessite un espace de travail payant ; les requêtes Web Pages provenant d’espaces Free renvoient ce statut. | | **404** | Le Brand Kit n’existe pas ou vous n’y avez pas accès. | | **412** | AEO n’est pas configuré pour ce Brand Kit. | | **422** | Spécifique aux analyses : `end_date` est aujourd’hui ou une date ultérieure, la plage de dates dépasse la limite de granularité, ou il y a plus de 3 dimensions. | *** ## Cas d’usage ### ETL et exportation de données AEO est une nouvelle catégorie de données que la plupart des stacks marketing n’ont pas encore. L’API vous permet de l’intégrer à votre entrepôt de données aux côtés des données SEO, paid et d’analytics web pour une analyse cross-canal. **À exporter :** | Tableau | Point de terminaison source | Stratégie de synchronisation | | -------------------------- | ----------------------------------------- | ------------------------------------------------------ | | Métriques de visibilité | Analytics (dimensions : date, provider) | Incrément quotidien — ajouter la ligne d’hier | | Tendances concurrentielles | Analytics (dimensions : date, competitor) | Incrément hebdomadaire | | Performance des pages | Pages web | Instantané quotidien — paginer toutes les pages | | Inventaire des citations | Citations | Instantané hebdomadaire — paginer toutes les citations | | Paysage des prompts | Prompts | Instantané hebdomadaire — paginer tous les prompts | **Options d’intégration :** * **Airflow / Dagster / Prefect** — Ajoutez un DAG qui appelle l’API, écrit le JSON dans S3/GCS et charge via `COPY INTO` * **Airbyte / Fivetran** — Utilisez le connecteur source d’API HTTP générique avec la méthode POST et une pagination par décalage * **Snowflake Snowpark** — Appelez l’API directement depuis une procédure stockée et planifiez avec Snowflake Tasks * **AWS Lambda + Snowpipe** — Une fonction sans serveur sur une tâche cron écrit vers S3, Snowpipe ingère automatiquement **Conseils pour le pipeline :** * `end_date` doit être une date passée — l’API ne fournit que des données finalisées, donc définissez-la à hier ou avant. Les requêtes avec la date d’aujourd’hui ou une date future renverront une `422` erreur. * Les métriques GSC et GA4 ont un **décalage de 4 jours** — les données des 3 jours les plus récents peuvent ne pas encore être disponibles * Utiliser `per_page=100` (le maximum) pour minimiser les allers-retours lors de la pagination * Vérifiez `meta.data_availability.requested_period_has_data` pour détecter les plages de dates vides avant le traitement * Le point de terminaison Analytics est plafonné à **1 000 lignes** par requête — pour les longues plages de temps avec des dimensions à forte cardinalité, segmentez en fenêtres selon la limite de granularité (120 jours en quotidien, 180 en hebdomadaire, 365 en mensuel) Le point de terminaison Web Pages est particulièrement utile pour l’ETL car il combine AEO + GSC + GA4 dans une seule réponse — vous évitant d’assembler trois sources de données distinctes. ### Looker Studio Nous fournissons un connecteur communautaire Looker Studio prêt à déployer qui visualise directement vos données AEO — sans ETL, sans entrepôt de données ni code. **Ce que vous obtenez :** Trois sources de données dans un seul connecteur : | Source de données | Ce qu’il montre | | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | **Analyse de la visibilité IA** | Taux de mention, part de voix, taux de citation, sentiment, et plus encore — ventilés par date, fournisseur, concurrent, sujet ou pays | | **Performance des pages** | Métriques AEO + Google Search Console + GA4 pré-jointes par URL dans une seule source de données | | **Citations** | URL des sources citées avec informations de domaine, sentiment, score d’influence et autorité de domaine | #### Obtenir votre clé API 1. Connectez-vous à [AirOps](https://app.airops.com) et allez à **Paramètres de l'espace de travail** 2. Trouvez la **Clé API** section 3. Copiez votre clé API — ou cliquez sur **Régénérer** si vous en avez besoin d’une nouvelle La clé s’authentifie en tant que jeton Bearer. Gardez-la confidentielle et ne l’exposez jamais dans du code côté client. > **Remarque :** La régénération de votre clé API invalide immédiatement l’ancienne. Si vous avez des intégrations existantes qui utilisent la clé, mettez-les à jour avant de régénérer. #### Connexion à Looker Studio 1. Ouvrez le [Connecteur AirOps AEO](https://lookerstudio.google.com/datasources/create?connectorId=AKfycbwR2EmDc6nXQkCLQNnn8EvUk_Z30Maf8wWD1sK3T13Zoe9LeeEQy3MtK6uzi_sU_1za) 2. **Autoriser** le connecteur lorsqu’on vous le demande par Google. Vous pouvez voir un avertissement « Google n’a pas vérifié cette application » — cliquez sur **Avancé** → **Aller à AirOps AEO Connector** pour continuer. Cela n’apparaît qu’une seule fois. 3. Saisissez votre **clé API AirOps** lorsqu’on vous le demande 4. Renseignez la configuration : * **ID du Brand Kit** — votre ID numérique de Brand Kit (visible dans l’URL du tableau de bord AirOps, par exemple, `app.airops.com/brand_kits/12345`) * **Source de données** — choisissez l’une des trois options : AI Visibility Analytics, Page Performance ou Citations 5. Cliquez sur **Connecter** — Looker Studio récupère automatiquement le schéma 6. Cliquez sur **Créer le rapport** pour commencer à construire > **Astuce :** Ajoutez le connecteur **trois fois** (une fois par source de données) pour obtenir les analytics, la performance des pages et les citations dans un seul rapport. Chaque source de données devient une source indépendante que vous pouvez utiliser dans n’importe quel graphique. #### Exemples de graphiques * **Série temporelle** — Taux de mention au fil du temps (Analytics : Date + Taux de mention) * **Graphique en barres** — Part de voix par fournisseur d’IA (Analytics : Fournisseur d’IA + Part de voix) * **Comparaison concurrentielle** — Barres groupées du taux de mention par concurrent * **Tableau des meilleures pages** — URL avec citations, clics GSC et trafic GA4 côte à côte (Pages) * **Nuage de points** — Citations vs clics GSC pour trouver les pages gagnantes à la fois en AEO et en SEO (Pages) * **Principaux domaines citants** — Graphique en barres du domaine par citations (Citations) * **Répartition du sentiment** — Diagramme circulaire du sentiment de marque par nombre de citations (Citations) #### Champs disponibles **Analyse de la visibilité IA :** | Dimensions | Métriques | | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | Date, fournisseur d’IA, concurrent, sujet, pays | Taux de mention, part de voix, taux de citation, citations, sentiment, position moyenne, taux de première mention, réponses | **Performance des pages :** | Dimensions | Métriques | | ------------ | --------------------------------------------------------------------------------------------------------------------------------- | | URL, dossier | Citations, taux de citation, prompts, clics GSC, impressions GSC, CTR GSC, position GSC, trafic GA4, sessions GA4, engagement GA4 | **Citations :** | Dimensions | Métriques | | ---------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | | URL, domaine, catégorie de domaine, type de page, marque mentionnée, sentiment de marque | Citations, part de citations, taux de citation, score d’influence, autorité de domaine | #### Suggestion de mise en page du tableau de bord Un aperçu exécutif sur une seule page pourrait inclure : * **Ligne supérieure** — Widgets de scorecard pour le taux de mention, la part de voix, le taux de citation et le total des citations * **Milieu gauche** — Taux de mention au fil du temps (graphique en ligne) * **Milieu droit** — Part de voix par fournisseur d’IA (graphique en barres) * **Bas gauche** — Tableau des meilleures pages (URL, citations, clics GSC, trafic GA4) * **Bas droit** — Principaux domaines citants (graphique en barres) Ajoutez une **Widget de plage de dates** à ajouter au rapport — les trois sources de données le respectent automatiquement. Les données d’aujourd’hui sont exclues car elles sont incomplètes. #### Limites * L’API Analytics autorise un maximum de **3 dimensions** par requête * Page Performance et Citations renvoient les **500 premières lignes** par chargement * Il s’agit d’un connecteur communautaire — chaque utilisateur doit l’autoriser lors de sa première utilisation ### Tableaux de bord personnalisés Créez des tableaux de bord internes dans Retool, Metabase ou Grafana. Le point de terminaison analytics est suffisamment flexible pour alimenter un tableau de bord entier à partir d’un seul point de terminaison — il suffit de changer les dimensions. ### Rapports automatisés Planifiez un script pour récupérer les métriques hebdomadaires et envoyer un résumé Slack ou un digest par e-mail à votre équipe. Le point de terminaison analytics avec `competitor` et `date` les dimensions vous donne un rapport concurrentiel complet en un seul appel. ### Alertes Utilisez des filtres intelligents selon un calendrier pour détecter quand les pages commencent à perdre en visibilité IA ou quand les classements baissent. Déclenchez des alertes dans Slack, PagerDuty ou par e-mail lorsque le `losing_ai_visibility` filtre renvoie des résultats. ### Priorisation du contenu Combinez `taux_de_citation`, `influence_score`, et des filtres intelligents pour classer de manière programmatique quelles pages optimiser en premier. Alimentez la liste priorisée dans votre calendrier éditorial ou votre outil de gestion de projet. *** Pour la spécification complète des points de terminaison, y compris les schémas de requête/réponse, consultez le [Référence de l'API](https://docs.airops.com/api-reference/api-reference/brand-kits). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.airops.com/docs/fr/developpeurs/api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.