# AEO Page Data

The AEO Page Data step lets you pull page-level analytics data directly into your workflows. Access citation rates, traffic metrics, and search performance for any URL you're tracking, combining AI search visibility with Google Analytics and Search Console data.

### Overview

**What it does:** Get comprehensive page-level data for any URL across AI search, Google Analytics 4, and Google Search Console. This step connects your [Pages](/insights/pages.md) data directly to workflows, enabling you to act on insights programmatically.

**When to use it:**

* Automate content refresh decisions based on page performance
* Build prioritization workflows that combine AI and SEO metrics
* Create reports that track page-level AI citation trends
* Trigger content optimization based on declining metrics
* Feed page data into content generation workflows

**Key benefits:**

* **Go from insight to action:** Transform your Pages analytics into automated workflows
* **Unified data access** across AI search, GSC, and GA4 from a single step
* **Page-level granularity** for precise content optimization decisions
* **Flexible time ranges** to analyze trends over 7, 30, or 90 days
* **Direct workflow integration:** Use page performance to trigger actions

### Data Sources

The AEO Page Data step combines data from three sources for each URL:

#### AI Search Data

| Metric             | Description                                                                              |
| ------------------ | ---------------------------------------------------------------------------------------- |
| **Citation Rate**  | How often this page is cited in AI responses (percentage of answers that cite this page) |
| **Citation Share** | This page's portion of total citations across all your tracked pages                     |
| **Citations**      | Total number of times your page is referenced in AI responses                            |
| **Unique Prompts** | Number of distinct prompts where this page has been cited                                |

#### Google Search Console Data

| Metric               | Description                                                        |
| -------------------- | ------------------------------------------------------------------ |
| **Clicks**           | Total clicks from organic search                                   |
| **Impressions**      | Number of times your page appeared in search results               |
| **Average Position** | Your average ranking position                                      |
| **CTR**              | Click-through rate (percentage of impressions resulting in clicks) |

#### Google Analytics 4 Data

| Metric                    | Description                                 |
| ------------------------- | ------------------------------------------- |
| **Sessions**              | Total session count for the page            |
| **Users**                 | Number of unique users who visited the page |
| **Avg. Session Duration** | How long users spend on the page            |
| **Engagement Rate**       | Percentage of engaged sessions              |

### Supported AI Platforms

Data is aggregated across all major AI platforms:

| Platform               | Description                                        |
| ---------------------- | -------------------------------------------------- |
| **ChatGPT**            | OpenAI's conversational AI assistant               |
| **Perplexity**         | AI-powered answer engine with real-time web search |
| **Gemini**             | Google's multimodal AI assistant                   |
| **Google AI Mode**     | Google Search's AI-powered response mode           |
| **Google AI Overview** | AI-generated summaries in Google Search results    |

You can filter to specific platforms using the multi-select dropdown in the step configuration.

### Step Configuration Guide

When setting up your **AEO Page Data** step, configure these fields:

#### 1. Page URL *(Required)*

**Description:** The URL of the page you want to analyze. This should be a page that exists in your [Pages](/insights/pages.md) view.

**Format:** Full URL including protocol (e.g., `https://example.com/your-page`)

**Tips:**

* Use Liquid templating to dynamically pass URLs from previous steps
* Reference URLs from Grid columns for bulk processing

#### 2. Brand Kit *(Required)*

**Description:** Select the [Brand Kit](/context/brand-kit.md) associated with this page's tracking. The Brand Kit determines which prompts and competitors are relevant for the analysis.

#### 3. Platform *(Multi-select)*

**Description:** Select which AI platforms to include in the citation analysis.

**Options:** ChatGPT, Perplexity, Gemini, Google AI Mode, Google AI Overview (all selected by default)

#### 4. Time Range *(Required)*

**Description:** Determines the date range for citation and prompt data.

**Options:**

* **Last 7 days**: Most recent snapshot
* **Last 30 days**: Monthly trend analysis
* **Last 90 days**: Quarterly performance review

### Sample Response

```json
{
  "url": "https://techcorp.com/enterprise-security-guide",
  "ai_search": {
    "citation_rate": 0.42,
    "citation_share": 0.15,
    "total_citations": 127,
    "unique_prompts": 23
  },
  "gsc": {
    "clicks": 4521,
    "impressions": 89432,
    "average_position": 4.2,
    "ctr": 0.051
  },
  "ga4": {
    "sessions": 5234,
    "users": 4102,
    "avg_session_duration": 184,
    "engagement_rate": 0.68
  },
  "prompts": [
    {
      "prompt": "best enterprise security tools 2026",
      "citation_rate": 0.73,
      "mention_rate": 0.45
    },
    {
      "prompt": "how to secure enterprise data",
      "citation_rate": 0.58,
      "mention_rate": 0.32
    }
  ]
}
```

### Use Cases

#### Content Refresh Prioritization

Build workflows that automatically identify pages needing attention:

1. Pull page data for URLs from a Grid
2. Filter for pages with declining citation rates but strong SEO metrics
3. Route to content analysis and refresh workflows

#### Performance-Based Content Updates

Trigger content updates based on real performance data:

1. Pull page data and check citation rate trends
2. If citation rate dropped >20%, analyze competitor content
3. Generate content recommendations or refreshed content

#### Multi-Channel Reporting

Create comprehensive page performance reports:

1. Pull page data for key URLs
2. Combine AI search, SEO, and traffic metrics
3. Output to Google Sheets for stakeholder review
4. Schedule weekly updates via workflow triggers

#### Gap Analysis Workflows

Identify pages with untapped AI potential:

1. Pull page data for high-SEO-traffic pages
2. Filter for low citation rates
3. Analyze what's missing for AI visibility
4. Generate optimization recommendations

### Best Practices

**Start with your highest-value pages:** Focus on pages that drive significant organic traffic or conversions first.

**Combine with AEO Prompt Data:** Use both steps together. AEO Prompt Data for prompt-level competitive analysis, AEO Page Data for page-level performance tracking.

**Set up regular monitoring:** Schedule workflows to run weekly or monthly to track trends over time.

**Use time range strategically:** Use 7-day data for rapid iteration, 30-day for monthly reviews, and 90-day for quarterly planning.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.airops.com/actions/workflow-concepts/workflow-steps/aeo-research/aeo-page-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.