> 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/de/entwickler/api.md). # Insights API Die AirOps Insights API: eine API für AEO- und KI-Zitier-Tracking mit programmgesteuertem Zugriff auf Erwähnungsrate, Share of Voice, Zitate und Seitenleistung für benutzerdefinierte Dashboards, ETL und Berichte. Die Insights API ist AirOps' API zur Antwortmaschinenoptimierung (AEO) und zur Nachverfolgung von KI-Zitierungen und bietet Ihnen programmgesteuerten Zugriff auf dieselben Daten, die Sie in Ihrem Insights-Dashboard sehen — Erwähnungsraten, Zitate, Stimmanteil, Seitenleistung und mehr. Verwenden Sie sie, um benutzerdefinierte Dashboards zu erstellen, Berichte zu automatisieren oder AEO-Daten zusammen mit Ihren anderen Marketingmetriken in Ihr Data Warehouse zu leiten. Alle Insights-Endpunkte befinden sich unter `/public_api/brand_kits` und erfordern ein Brand Kit mit aktiviertem AEO. Für die Authentifizierungseinrichtung siehe die [API-Referenz](https://docs.airops.com/api-reference). *** ## Datenmodell Das Brand Kit ist die Wurzelressource. Alles andere verbindet sich damit: | Ressource | Was sie enthält | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Analysen** | Flexible Metrikabfragen — Erwähnungsrate, Stimmanteil, Zitierate, Stimmung und mehr — aufgeschlüsselt nach Anbieter, Wettbewerber, Thema, Land oder Datum | | **Webseiten** | Ihre verfolgten Seiten mit kombinierten AEO-Zitaten-, Google-Search-Console- und GA4-Metriken | | **Prompts** | KI-Fragen, die verfolgt werden, mit Erwähnungs-/Zitierungsraten und Trends | | **Zitate** | URLs, die in KI-Antworten zitiert werden, mit Einflussbewertung und Stimmung | | **Wettbewerber** | Domains, die Sie für die Wettbewerbsanalyse überwachen | | **Themen** | Kategorien, die Ihre Prompts organisieren | | **Personas** | Zielgruppenprofile, die für die Prompt-Analyse verwendet werden | *** ## Schnellstart ### 1. Finden Sie Ihr Brand Kit ```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 }] }' ``` Die Antwort enthält Ihr Brand Kit `id` — verwenden Sie sie in allen nachfolgenden Aufrufen. ### 2. Fragen Sie Ihre KI-Sichtbarkeit ab ```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. Finden Sie Seiten, die Aufmerksamkeit benötigen ```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" }' ``` Drei Aufrufe und Sie haben: Ihren Sichtbarkeitstrend, die Wettbewerbsposition und welche Seiten Arbeit benötigen. *** ## Endpunkte ### Welchen Endpunkt brauche ich? | Ich möchte ... | Verwenden | | -------------------------------------------------- | ------------------------------------- | | Meine allgemeinen KI-Sichtbarkeitsmetriken abrufen | Analysen | | Im Zeitverlauf mit Wettbewerbern vergleichen | Analysen mit `Wettbewerber` Dimension | | Die Leistung nach KI-Anbieter aufschlüsseln | Analysen mit `Anbieter` Dimension | | Seiten finden, die Zitate oder Rankings verlieren | Webseiten mit Smart-Filtern | | AEO + SEO + Verkehrsdaten pro Seite abrufen | Webseiten | | Sehen, welche KI-Fragen meine Marke erwähnen | Prompts | | Sehen, welche URLs zitiert werden | Zitate | ### Analysen `POST /public_api/brand_kits/{id}/analytics` Der flexibelste Endpunkt. Wählen Sie jede beliebige Kombination aus Metriken und Dimensionen, um genau die Abfrage zu erstellen, die Sie benötigen. **Metriken:** | Metrik | Beschreibung | | -------------------- | ----------------------------------------------------------- | | `mention_rate` | % der KI-Antworten, die Ihre Marke erwähnen (0-100) | | `share_of_voice` | Ihre Erwähnungen / (Ihre + Wettbewerber) (0-100) | | `citation_rate` | % der KI-Antworten, die Ihre Seiten zitieren (0-100) | | `citation_share` | Ihre Zitate / Gesamtzitate (0-100) | | `citation_count` | Absolute Anzahl an Zitaten | | `sentiment_score` | Stimmung der Markenerwähnungen (0-100) | | `average_position` | Durchschnittliche Position in KI-Antwortlisten | | `answer_count` | Gesamtzahl der analysierten KI-Antworten | | `first_mention_rate` | % der Antworten, in denen Sie zuerst erwähnt werden (0-100) | **Dimensionen** (bis zu 3 pro Abfrage): `date`, `Anbieter`, `topic`, `country`, `persona`, `domain`, `Wettbewerber`, `domain_category` **Zeitgranularität:** `täglich` (max. 120 Tage), `wöchentlich` (max. 180 Tage), `monatlich` (max. 365 Tage), `gesamt` (max. 365 Tage) **Filter:** `Anbieter`, `Themen`, `Länder`, `Personas`, `brand_mentioned` **Grenzen:** Max. 1.000 Zeilen pro Abfrage. Standard: 100. ### Webseiten `POST /public_api/brand_kits/{id}/web_pages/list` Ihre verfolgten Seiten kombinieren Zitations-, Such-, Traffic- und Agent-Analytics-Daten in einer einzigen Antwort: | Quelle | Metriken | | ------------------------- | --------------------------------------------------------------------------------------------------------- | | **AEO** | `citations_count`, `citation_rate`, `prompts_count` | | **Google Search Console** | `clicks`, `impressions`, `ctr`, `position` | | **Google Analytics 4** | `Traffic`, `sessions`, `Engagement`, `average_session_engagement` | | **Agent Analytics** | `user_browse` (Besuche durch KI-Agenten), `ai_training` (Trainings-Crawls), `ai_search` (Websuche-Crawls) | Die Felder von Agent Analytics sind filter- und sortierbare Zählwerte für den ausgewählten Datumsbereich. Verbinden Sie zuerst Agent Analytics, um diese Daten zu erfassen. Diese Felder enthalten keine Varianten für Veränderungen im Vergleich zum vorherigen Zeitraum. `total_crawls` ist kein Feld auf diesem Endpunkt; verwenden Sie stattdessen den untenstehenden Agent-Analytics-Endpunkt für diese Berechnung. Kostenlose Workspaces erhalten **402 Zahlung erforderlich** vom Web-Pages-Endpunkt. **Smart-Filter** zeigen gängige Chancen auf: | Filter | Was es findet | | ----------------------- | ------------------------------------------ | | `almost_page_one` | Seiten auf Rang 10–20 | | `losing_clicks` | Zurückgehende Klicks bei stabilen Rankings | | `rankings_slipping` | SERP-Position sinkt über 90 Tage | | `losing_ai_visibility` | Seiten, die KI-Zitate verlieren | | `citation_rate_decline` | Verlust an KI-Autorität trotz stabilem SEO | 26+ filterbare Felder mit Operatoren: `EQ`, `NEQ`, `GT`, `LT`, `GEQ`, `LEQ`, `CONTAINS`, `STARTS_WITH`, `IN` ### Agent Analytics `POST /public_api/brand_kits/{id}/agent_analytics/list` Gibt tägliche Anfragezahlen für die vom Brand Kit verfolgten Seiten zurück, nachdem Sie [Agent Analytics verbunden](/docs/de/insights/onsite/traffic.md). Jede Zeile enthält `date`, `platform`, `crawl_type`und `count`. Zeilen ohne Anfragen werden ausgelassen. Geben Sie `start_date` und `end_date` an, um einen Zeitraum auszuwählen. Sie können nach `platform`, `crawl_type`, oder einer einzelnen `web_page_id`, filtern und nach `date` oder `count` (`-count` für die größten zuerst sortieren). Die Paginierung ist standardmäßig auf 25 Zeilen eingestellt und unterstützt bis zu 100 pro Seite. Lesen Sie jede Seite, bevor Sie Gesamtwerte berechnen. | Ergebnis | Berechnung | | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | | Agent Analytics **Gesamt-Crawls** | Summe `ai_search` und `ai_training` für verfolgte Engines. | | **Besuche durch KI-Agenten** | Summe `user_browse` für verfolgte Engines. | | **Top-Crawling-Engine** | Die verfolgte Engine mit der größten kombinierten `ai_search` und `ai_training` Anzahl. | | **Aufschlüsselung nach Crawling-Typ** | Jeder von `ai_search` und `ai_training` als Prozentsatz ihres kombinierten Gesamtwerts für verfolgte Engines. | | **Aufschlüsselung nach Engine** | Nach verfolgter Engine gruppieren und Trainings-Crawls, Websuche-Crawls, deren kombinierten Gesamtwert und Besuche durch KI-Agenten summieren. | | **Crawl-Aktivität vs. Besuche durch KI-Agenten** | Nach Datum und Crawling-Typ über alle zurückgegebenen Plattformen gruppieren, einschließlich `andere` Anfragen. | | **Besuche durch KI-Agenten im Zeitverlauf** | Gruppieren `user_browse` nach Datum und verfolgter Engine. | Die für diese Berechnungen verfolgten Engines sind `chat_gpt`, `perplexity`, `gemini`, `google_ai_mode`und `claude`. Die Antwort enthält außerdem andere Plattformen, wie etwa allgemeine Such-Crawler. Um mit der **Seiten** Tabelle **Gesamt-Crawls** für eine Seite zu entsprechen, filtern Sie nach ihrer `web_page_id` und summieren Sie alle Zeilen, einschließlich jeder Plattform und jedes Crawling-Typs. Dies unterscheidet sich vom ausschließlich KI-bezogenen Crawl-Gesamtwert der Agent-Analytics-Zusammenfassung. {% hint style="info" %} Der tägliche Endpunkt folgt der Datumsgrenze des Agent-Analytics-Tabs: Eine Anfrage genau um Mitternacht nach `end_date` kann als eine Zeile mit dem Datum des nächsten Tages erscheinen. Schließen Sie Zeilen aus, die nach `end_date` liegen, beim Abgleich mit der Seiten-Tabelle. {% endhint %} ### Prompts `POST /public_api/brand_kits/{id}/prompts/list` · `GET /public_api/brand_kits/{id}/prompts/{id}` KI-Fragen, die für Ihre Marke verfolgt werden. Jeder Prompt enthält `mention_rate`, `citation_rate`, und Trends im Vergleich zum vorherigen Zeitraum (`mention_rate_trend`, `citation_rate_trend`). Filtern nach `Text`, `brand_mentioned`, `topic_id`, `prompt_volume`, `mention_rate`, `citation_rate`. Schränken Sie Metriken mit Kontextfiltern auf bestimmte Anbieter, Länder oder Personas ein. ### Antwortabsicht Antwortlisten- und Detailantworten legen die schreibgeschützte `intent_stage`: `awareness`, `consideration`, `evaluation`, oder `purchase`. Sie ist `null` wenn keine Klassifizierung verfügbar ist. Dasselbe Feld ist über MCP-Antwortwerkzeuge verfügbar. ### Zitate `POST /public_api/brand_kits/{id}/citations/list` · `POST /public_api/brand_kits/{id}/citations/show` URLs, die in KI-Antworten zitiert werden, jeweils bewertet mit einer `influence_score` (0-100), die Domain-Autorität, Zitierhäufigkeit und Relevanz berücksichtigt. Enthält `brand_sentiment` (positiv/neutral/negativ) und `domain_category`. Sortieren nach `citation_count`, `citation_share`, `citation_rate`, oder `influence_score`. Bei Zitaten und Domains, `prompt_type` mit `EQUALS` und Wert `brand` oder `category` beschreibt den Prompt. `brand_mentioned` mit `EQ` und Wert `true` oder `false` beschreibt, ob die zitierende Seite Ihre Marke erwähnt. Diese Filter können kombiniert werden: ```json { "filters": [ { "field": "prompt_type", "operator": "EQUALS", "value": "category" }, { "field": "brand_mentioned", "operator": "EQ", "value": true } ] } ``` Die frühere `brand_mentioned EQUALS brand/category` und `brand_referenced EQ true/false` Aliase bleiben akzeptiert. Die expliziten neuen Filter haben Vorrang, wenn beide Formen vorhanden sind. Auf dem Prompts-Endpunkt, `brand_mentioned EQ true/false` beschreibt weiterhin den Prompt-Text. Die Antworten der Zitierlisten und Detailansichten enthalten ein `Social` Feld, wenn unterstützte Social-Metadaten vorhanden sind. Es identifiziert die Plattform und enthält `Inhalt` und `Konto` Objekte mit Metadaten, Metriken und Synchronisationsstatus. `Social` ist `null` wenn kein unterstützter Social-Datensatz vorhanden ist; `social.account` kann `null` auch dann, wenn Inhalt vorhanden ist. Metadaten können unvollständig sein, während die Erfassung aussteht oder nach einer fehlgeschlagenen Erfassung. YouTube-Inhaltsmetadaten enthalten außerdem `duration_seconds`, `format`und `sponsorship_status`. Die Dauer kann `null`; Format und Sponsoring-Status verwenden `unknown` wenn die Informationen nicht verfügbar sind. ### Beobachtete Anzeigen `POST /public_api/aeo/brand_kits/{id}/ads/list` · `POST /public_api/aeo/brand_kits/{id}/ads/show` Fragen Sie ChatGPT- und Google-AI-Mode-Anzeigen ab, die AirOps für die verfolgten Prompts des Brand Kits beobachtet. Diese Endpunkte verwenden dieselben beobachteten Anzeigendaten wie [Anzeigenbibliothek](/docs/de/insights/ads.md#ad-library) und erfordern keine Verbindung zu einem ChatGPT-Ads-Konto. Sie erfordern Zugriff auf die Anzeigendaten des Brand Kits. | Endpunkt | Gibt zurück | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Liste** | Eine Zeile pro Anbieter und beobachteter Anzeige mit Details zum Werbetreibenden, Titel und Text, Vorkommen, eindeutigen Antworten, Prompts, Häufigkeit und Beobachtungsverlauf | | **Anzeigen** | Details zu einer anbieterspezifischen Anzeige, Bild und Ziel-URL, Werbetreibendem und Beobachtungsverlauf | Übergeben Sie das observed\_creative\_id aus dem Listen-Ergebnis `observed_creative_id` als `id` und dessen `Anbieter` als einzelnes Element `Anbieter` Array für den Show-Endpunkt. Dies identifiziert ein beobachtetes Creative auf dieser Plattform, nicht eine Ressource in Ihrem verbundenen Anzeigenkonto. Dasselbe Creative kann separate Listenzeilen für verschiedene Plattformen haben. Listen enthalten standardmäßig beide unterstützten Anbieter. Verwenden Sie `providers: ["chat_gpt"]` oder `providers: ["google_ai_mode"]` um einen auszuwählen. Show-Anfragen verwenden standardmäßig ChatGPT, wenn weggelassen, und erfordern genau einen Anbieter, wenn angegeben. Listenfilter umfassen `topic_id`, `prompt_id`und `prompt_type` (`EQUALS` mit `brand` oder `category`). Das alte `brand_mentioned` prompt-type-Alias wird weiterhin akzeptiert. Begrenzen Sie Anfragen mit `start_date`, `end_date`, `Anbieter`, `Länder`, `Personas`und `tags`. Die Liste unterstützt Paginierung und Feldauswahl. `Vorkommen` zählt Anzeigenvorkommen; `Antworten` zählt unterschiedliche erfasste Antworten, die die Anzeige enthalten. `Frequenz` ist der Prozentsatz der verfolgten Antworten im Geltungsbereich, die es enthalten. `first_seen` und `last_seen` decken die Beobachtungshistorie der Anzeige ab, und `days_active` ist die inklusive Spanne dazwischen. Der Show-Endpunkt gibt die Fenster-Metriken der Liste für Vorkommen, Antworten, Prompts oder Frequenz nicht zurück. Diese Beobachtungen belegen weder eine vollständige Marktabdeckung, die Ausgaben des Werbetreibenden noch die Zielgruppenabsicht. Die entsprechenden MCP-Tools sind [list\_aeo\_ads and get\_aeo\_ad](/docs/de/entwickler/tools.md#list_aeo_ads). ### Wettbewerber, Themen, 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}` Referenzdaten für Ihre Brand-Kit-Konfiguration. Verwenden Sie diese IDs beim Filtern anderer Endpunkte. *** ## Allgemeine Muster ### Paginierung Alle Listenendpunkte verwenden offset-basierte Paginierung mit maximal 100 Elementen pro Seite. ```json { "page": 1, "per_page": 100 } ``` Antworten enthalten `meta.total_count` und `meta.total_pages`. Wiederholen Sie, bis `page >= total_pages`. ### Filtern Übergeben Sie ein `filters` Array im Request-Body: ```json { "filters": [ { "field": "citation_rate", "operator": "GT", "value": 5 }, { "field": "brand_mentioned", "operator": "EQ", "value": true } ] } ``` | Gib | Operatoren | | --------- | ------------------------------------- | | Text | `EQUALS`, `CONTAINS`, `STARTS_WITH` | | Numerisch | `EQ`, `NEQ`, `GT`, `LT`, `GEQ`, `LEQ` | | Menge | `IN` | ### Sortierung Übergeben Sie ein `sort` String. Präfixe mit `-` für absteigend: ```json { "sort": "-citation_rate" } ``` ### Feldauswahl Übergeben Sie ein `fields` Array, um die zurückgegebenen Felder zu begrenzen: ```json { "fields": ["url", "citations_count", "clicks", "position"] } ``` ### Datumsbereiche Metrik-Endpunkte akzeptieren `start_date` und `end_date` im `YYYY-MM-DD` Format. Standardmäßig die letzten 30 Tage, wenn weggelassen. * `end_date` muss vor heute liegen * GSC- und GA4-Metriken haben eine Verzögerung von 4 Tagen ### Datenverfügbarkeit Jede Metrikantwort enthält ein `data_availability` Objekt: ```json { "data_availability": { "earliest_data_date": "2025-10-15", "latest_data_date": "2026-02-18", "requested_period_has_data": true } } ``` Prüfen Sie `requested_period_has_data` vor der Verarbeitung der Ergebnisse. *** ## Unterstützte KI-Anbieter Verwenden Sie diese Werte im `Anbieter` Filter: | Wert | Plattform | | -------------------- | ------------------ | | `chat_gpt` | ChatGPT | | `gemini` | Google Gemini | | `perplexity` | Perplexity | | `google_ai_mode` | Google AI Mode | | `google_ai_overview` | Google AI Overview | | `claude` | Claude | Claude ist in Enterprise-Workspaces standardmäßig verfügbar. Jede Claude-Antwort verwendet vier Abrechnungseinheiten: vier Tasks in einem Combined-Task-Workspace oder vier Answer Credits in einem Legacy-Workspace. Siehe [Nutzung und Abrechnung von AEO Answers](/docs/de/dein-workspace/settings/billing.md#aeo-answers-usage-and-billing). *** ## Unterstützte Länder AirOps akzeptiert diese 49 Region-Codes. Übergeben Sie ISO-3166-1-Alpha-2-Codes im `Länder` Filter: `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` Die Plattformabdeckung variiert je nach Region. Eine Region in dieser Liste garantiert nicht, dass jeder KI-Anbieter dort Antworten erfasst. Kenia wird beispielsweise für ChatGPT, Google AI Overview, Google AI Mode und Claude unterstützt; andere Anbieter sind möglicherweise nicht verfügbar. *** ## Fehler | Status | Bedeutung | | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **400** | Ungültiger Filter-, Operator- oder Sortierfeldwert. Prüfen Sie `validation_errors` in der Antwort. | | **401** | Fehlender oder ungültiger API-Schlüssel. | | **402** | Der Endpunkt erfordert einen kostenpflichtigen Workspace; Web-Pages-Anfragen aus Free-Workspaces geben diesen Status zurück. | | **404** | Das Brand Kit existiert nicht oder Sie haben keinen Zugriff. | | **412** | AEO ist für dieses Brand Kit nicht konfiguriert. | | **422** | Analytics-spezifisch: `end_date` ist heute oder später, der Datumsbereich überschreitet das Granularitätslimit oder es werden mehr als 3 Dimensionen verwendet. | *** ## Anwendungsfälle ### ETL & Datenexport AEO ist eine neue Datenkategorie, die die meisten Marketing-Stacks noch nicht haben. Die API ermöglicht es Ihnen, sie zusammen mit SEO-, Paid- und Web-Analytics-Daten in Ihrem Warehouse abzulegen und kanalübergreifend zu analysieren. **Was exportiert werden soll:** | Tabelle | Quell-Endpunkt | Synchronisierungsstrategie | | --------------------- | -------------------------------------------- | --------------------------------------------------------------- | | Sichtbarkeitsmetriken | Analytics (Dimensionen: Datum, Anbieter) | Tägliches inkrementelles Laden — die Zeile von gestern anhängen | | Wettbewerbstrends | Analytics (Dimensionen: Datum, Wettbewerber) | Wöchentlich inkrementell | | Seitenleistung | Webseiten | Täglicher Snapshot — alle Seiten paginieren | | Zitationsinventar | Zitate | Wöchentlicher Snapshot — alle Zitate paginieren | | Prompt-Landschaft | Prompts | Wöchentlicher Snapshot — alle Prompts paginieren | **Integrationsoptionen:** * **Airflow / Dagster / Prefect** — Fügen Sie einen DAG hinzu, der die API aufruft, JSON in S3/GCS schreibt und lädt über `COPY INTO` * **Airbyte / Fivetran** — Verwenden Sie den generischen HTTP-API-Quell-Connector mit POST-Methode und offset-basierter Paginierung * **Snowflake Snowpark** — Rufen Sie die API direkt aus einer gespeicherten Prozedur auf und planen Sie sie mit Snowflake Tasks * **AWS Lambda + Snowpipe** — Eine serverlose Funktion schreibt per Cron in S3, Snowpipe lädt automatisch ein **Pipeline-Tipps:** * `end_date` muss ein Datum in der Vergangenheit sein — die API liefert nur finalisierte Daten, setzen Sie ihn daher auf gestern oder früher. Anfragen mit dem heutigen Datum oder einem zukünftigen Datum geben einen `422` Fehler zurück. * GSC- und GA4-Metriken haben eine **Verzögerung von 4 Tagen** — Daten für die letzten 3 Tage sind möglicherweise noch nicht verfügbar * Verwenden `per_page=100` (das Maximum), um die Anzahl der Roundtrips beim Paginieren zu minimieren * Prüfen Sie `meta.data_availability.requested_period_has_data` um leere Datumsbereiche vor der Verarbeitung zu erkennen * Der Analytics-Endpunkt begrenzt auf **1.000 Zeilen** pro Abfrage — bei langen Zeiträumen mit hochkartinalen Dimensionen in Fenster aufteilen, basierend auf dem Granularitätslimit (120 Tage täglich, 180 wöchentlich, 365 monatlich) Der Web-Pages-Endpunkt ist für ETL besonders wertvoll, da er AEO + GSC + GA4 in einer einzigen Antwort kombiniert — so müssen Sie nicht drei separate Datenquellen zusammenführen. ### Looker Studio Wir stellen einen sofort einsetzbaren Looker-Studio-Community-Connector bereit, der Ihre AEO-Daten direkt visualisiert — kein ETL, kein Data Warehouse und kein Programmieren erforderlich. **Was Sie erhalten:** Drei Datenquellen in einem Connector: | Datenquelle | Was es anzeigt | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | **KI-Sichtbarkeitsanalysen** | Mention Rate, Share of Voice, Citation Rate, Sentiment und mehr — aufgeschlüsselt nach Datum, Anbieter, Wettbewerber, Thema oder Land | | **Seitenleistung** | AEO + Google Search Console + GA4-Metriken pro URL bereits zusammengeführt in einer einzigen Datenquelle | | **Zitate** | Quell-URLs mit Domain-Infos, Sentiment, Influence Score und Domain Authority | #### So erhalten Sie Ihren API-Schlüssel 1. Melden Sie sich bei [AirOps](https://app.airops.com) und gehen Sie zu **Arbeitsbereichseinstellungen** 2. Suchen Sie den **API-Schlüssel** Bereich 3. Kopieren Sie Ihren API-Schlüssel — oder klicken Sie auf **Neu generieren** wenn Sie einen neuen benötigen Der Schlüssel authentifiziert sich als Bearer-Token. Bewahren Sie ihn vertraulich auf und geben Sie ihn niemals in clientseitigem Code preis. > **Hinweis:** Das Neu generieren Ihres API-Schlüssels macht den alten sofort ungültig. Wenn Sie bestehende Integrationen mit dem Schlüssel haben, aktualisieren Sie diese vor dem Neu generieren. #### Verbindung mit Looker Studio herstellen 1. Öffnen Sie das [AirOps AEO Connector](https://lookerstudio.google.com/datasources/create?connectorId=AKfycbwR2EmDc6nXQkCLQNnn8EvUk_Z30Maf8wWD1sK3T13Zoe9LeeEQy3MtK6uzi_sU_1za) 2. **Autorisieren** den Connector, wenn Sie von Google dazu aufgefordert werden. Möglicherweise sehen Sie die Warnung „Google hat diese App nicht überprüft“ — klicken Sie auf **Erweitert** → **Zum AirOps AEO Connector gehen** um fortzufahren. Dies wird nur einmal angezeigt. 3. Geben Sie Ihren **AirOps-API-Schlüssel** ein, wenn Sie dazu aufgefordert werden 4. Füllen Sie die Konfiguration aus: * **Brand-Kit-ID** — Ihre numerische Brand-Kit-ID (sichtbar in der URL des AirOps-Dashboards, z. B., `app.airops.com/brand_kits/12345`) * **Datenquelle** — wählen Sie eine der drei Optionen: AI Visibility Analytics, Page Performance oder Citations 5. Klicken Sie auf **Verbinden** — Looker Studio ruft das Schema automatisch ab 6. Klicken Sie auf **Bericht erstellen** um mit dem Erstellen zu beginnen > **Tipp:** Fügen Sie den Connector hinzu **dreimal** (einmal pro Datenquelle), um Analytics, Seitenleistung und Citations in einem Bericht zu erhalten. Jede Datenquelle wird zu einer unabhängigen Quelle, die Sie in jedem Diagramm verwenden können. #### Beispiel-Diagramme * **Zeitreihe** — Mention Rate im Zeitverlauf (Analytics: Datum + Mention Rate) * **Balkendiagramm** — Share of Voice nach KI-Anbieter (Analytics: KI-Anbieter + Share of Voice) * **Wettbewerbervergleich** — Gruppiertes Balkendiagramm der Mention Rate nach Wettbewerber * **Tabelle der Top-Seiten** — URL mit Citations, GSC-Klicks und GA4-Traffic nebeneinander (Pages) * **Streudiagramm** — Citations vs. GSC-Klicks, um Seiten zu finden, die sowohl bei AEO als auch bei SEO gewinnen (Pages) * **Top-verweisende Domains** — Balkendiagramm der Domain nach Citations (Citations) * **Sentiment-Aufschlüsselung** — Kreisdiagramm des Brand Sentiment nach Zitationsanzahl (Citations) #### Verfügbare Felder **AI Visibility Analytics:** | Dimensionen | Metriken | | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | Datum, KI-Anbieter, Wettbewerber, Thema, Land | Mention Rate, Share of Voice, Citation Rate, Citations, Sentiment, durchschnittliche Position, erste Mention Rate, Antworten | **Page Performance:** | Dimensionen | Metriken | | ----------- | ---------------------------------------------------------------------------------------------------------------------------------- | | URL, Ordner | Citations, Citation Rate, Prompts, GSC-Klicks, GSC-Impressionen, GSC-CTR, GSC-Position, GA4-Traffic, GA4-Sitzungen, GA4-Engagement | **Citations:** | Dimensionen | Metriken | | ----------------------------------------------------------------------- | --------------------------------------------------------------------------- | | URL, Domain, Domain-Kategorie, Seitentyp, Marke erwähnt, Markenstimmung | Citations, Citation Share, Citation Rate, Influence Score, Domain Authority | #### Vorschlag für das Dashboard-Layout Eine einseitige Executive-Übersicht könnte Folgendes enthalten: * **Obere Reihe** — Scorecard-Widgets für Mention Rate, Share of Voice, Citation Rate und Gesamtzitierungen * **Mitte links** — Mention Rate im Zeitverlauf (Liniendiagramm) * **Mitte rechts** — Share of Voice nach KI-Anbieter (Balkendiagramm) * **Unten links** — Tabelle der Top-Seiten (URL, Citations, GSC-Klicks, GA4-Traffic) * **Unten rechts** — Top-verweisende Domains (Balkendiagramm) Fügen Sie eine **Datumsbereichssteuerung** Widget zum Bericht hinzufügen — alle drei Datenquellen berücksichtigen es automatisch. Daten für heute werden ausgeschlossen, da sie unvollständig sind. #### Einschränkungen * Die Analytics-API erlaubt maximal **3 Dimensionen** pro Abfrage * Page Performance und Citations geben die **Top 500 Zeilen** pro Ladevorgang * Dies ist ein Community Connector — jeder Nutzer muss ihn bei der ersten Verwendung autorisieren ### Benutzerdefinierte Dashboards Erstellen Sie interne Dashboards in Retool, Metabase oder Grafana. Der Analytics-Endpunkt ist flexibel genug, um ein ganzes Dashboard aus einem einzigen Endpunkt zu versorgen — ändern Sie einfach die Dimensionen. ### Automatisierte Berichterstattung Planen Sie ein Skript, das wöchentliche Metriken abruft und Ihrem Team eine Slack-Zusammenfassung oder einen E-Mail-Bericht sendet. Der Analytics-Endpunkt mit `Wettbewerber` und `date` Dimensionen liefert Ihnen mit einem einzigen Aufruf einen vollständigen Wettbewerbsbericht. ### Alarmierung Verwenden Sie geplante Smart-Filter, um zu erkennen, wenn Seiten an KI-Sichtbarkeit verlieren oder Rankings abrutschen. Lösen Sie Benachrichtigungen in Slack, PagerDuty oder per E-Mail aus, wenn der `losing_ai_visibility` Filter Ergebnisse zurückgibt. ### Content-Priorisierung Kombinieren Sie `citation_rate`, `influence_score`, und Smart-Filter, um programmatisch zu priorisieren, welche Seiten zuerst optimiert werden sollen. Speisen Sie die priorisierte Liste in Ihren Content-Kalender oder Ihr Projektmanagement-Tool ein. *** Die vollständigen Endpunktspezifikationen einschließlich Request-/Response-Schemata finden Sie in der [API-Referenz](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/de/entwickler/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.