Documentation
HomeAPISign In
  • Getting Started
    • Overview
      • Core Concepts
      • Building your First Workflow
    • API Reference
  • Your Data
    • Brand Kits
    • Knowledge Bases
      • Add Data
        • Upload Files
        • Web Scrape
        • Import from Google Drive
        • Import from SQL Database
        • Import from Shopify
      • Knowledge Base Search
      • Knowledge Base Metadata
      • Knowledge Base API
  • Building Workflows
    • Workflow Concepts
      • Workflow Inputs
        • Input Types
      • Workflow Outputs
      • Variable Referencing
      • Liquid Templating
    • Workflow Steps
      • AI
        • Prompt LLM
          • Model Selection Guide
          • Prompting Guide
        • Transcribe Audio File
      • Web Research
        • Google Search
        • Web Page Scrape
      • Code
        • Run Code
        • Call API
        • Format JSON
        • Run SQL Query
        • Write Liquid Text
      • Flow
        • Condition
        • Iteration
        • Human Review
        • Content Comparison
        • Error
      • Data
        • Read from Grid
        • Write to Grid
        • Search Knowledge Base
        • Write to Knowledge Base
        • Get Knowledge Base File
      • AirOps
        • Workflow
        • Agent
      • Image & Video
        • Generate Image with API
        • Search Stock Images
        • Fetch Stock Image with ID
        • Resize Image
        • Screenshot from URL
        • Create OpenGraph Image
        • Create Video Avatar
      • SEO Research
        • Semrush
        • Data4SEO
      • Content Quality
        • Detect AI Content
        • Scan Content for Plagiarism
      • Content Processing
        • Convert Markdown to HTML
        • Convert PDF URL to Text
        • Group Keywords into Clusters
      • B2B Enrichment
        • Hunter.io
        • People Data Labs
      • CMS Integrations
        • Webflow
        • WordPress
        • Shopify
        • Contentful
        • Sanity
        • Strapi
      • Analytics Integrations
        • Google Search Console
      • Collaboration Integrations
        • Gmail
        • Google Docs
        • Google Sheets
        • Notion
        • Slack
    • Testing and Iteration
    • Publishing and Versioning
  • Running Workflows
    • Run Once
    • Run in Bulk (Grid)
    • Run via API
    • Run via Trigger
      • Incoming Webhook Trigger
      • Zapier
    • Run on a Schedule
    • Error Handling
  • Grids
    • Create a Grid
      • Import from Webflow
      • Import from Wordpress
      • Import from Semrush
      • Import from Google Search Console
    • Add Columns in the Grid
    • Run Workflows in the Grid
      • Add Workflow Column
      • Run Workflow Column
      • Map Workflow Outputs
      • Review Workflow Run Metadata
    • Review Content in the Grid
      • Review Markdown Content
      • Review HTML Content
      • Compare Content Difference
    • Publish to CMS from Grid
    • Pull Analytics in the Grid
    • Export as CSV
  • Copilot
    • Chat with Copilot
    • Edit Workflows with Copilot
    • Fix Errors with Copilot
  • Monitoring
    • Task Usage
    • Analytics
    • Alerts
    • Execution History
  • Your Workspace
    • Create a Workspace
    • Folders
    • Settings
    • Billing
    • Use your own LLM API Keys
    • Secrets
    • Team and Permissions
  • Chat Agents (Legacy)
    • Agent Quick Start
    • Chat Agents
    • Integrate Agents
      • Widget
      • Client Web SDK
  • About
    • Ethical AI and IP Production
    • Principles
    • Security and Compliance
Powered by GitBook
On this page

Was this helpful?

  1. Building Workflows
  2. Workflow Steps
  3. Analytics Integrations

Google Search Console

Last updated 2 months ago

Was this helpful?

AirOps allows you to connect directly to your Google Search Console account to get valuable search performance data within your workflows, helping you make data-driven decision with your content.

How to Configure the Google Search Console Integration Step

  1. Add the step to your workflow:

    • Click the "+" button to add a new step

    • Select "Google Search Console" under the "Integrations" section from the available steps

  2. Authentication:

    • Select an existing Google Search Console connection from the dropdown, or set up a new one

  3. Action Type:

    • Choose from the following available actions:

      • Get Query Performance Overview: Retrieves performance data for search queries that led to your site

      • Get Page Performance Overview: Retrieves performance data for specific pages on your site

      • Get Query Page Performance Breakdown: Provides detailed performance metrics between queries and pages

      • Get Page Indexing Status: Checks if a specific URL is indexed by Google and when it was last indexed

  4. Configure action-specific parameters:

    • Site Selection: Choose which Google Search Console property to query

    • URL: For page-specific actions, enter the URL you want to analyze

    • Period: For performance data, select the time frame (Last 7 days, Last 28 days, Last 3 months, etc.)

  5. Output formats vary by action type:

    • Query Performance: Returns data including query text, clicks, impressions, CTR, and position in the following JSON format

{
  "queries": [
    {
      "query": "string",  // The search query text
      "clicks": number,   // Count of clicks from this query
      "impressions": number,  // Count of impressions for this query
      "ctr": number,      // Click-through rate (decimal format)
      "position": number  // Average position in search results
    }
    // Multiple query objects will be returned
  ]
}
  • Page Performance: Returns data about specific pages including clicks, impressions, and ranking

{
  "clicks": {
    "L7D": number,       // Total clicks in the Last 7 Days
    "L30D": number,      // Total clicks in the Last 30 Days
    "WoW Change": number, // Week-over-Week change in clicks (can be positive or negative)
    "MoM Change": number  // Month-over-Month change in clicks (can be positive or negative)
  },
  "impressions": {
    "L7D": number,       // Total impressions in the Last 7 Days
    "L30D": number,      // Total impressions in the Last 30 Days
    "WoW Change": number, // Week-over-Week change in impressions
    "MoM Change": number  // Month-over-Month change in impressions
  },
  "ctr": {
    "L7D": number,       // Average Click-Through Rate for the Last 7 Days (expressed as percentage)
    "L30D": number,      // Average Click-Through Rate for the Last 30 Days (expressed as percentage)
    "WoW Change": number, // Week-over-Week change in CTR (percentage points)
    "MoM Change": number  // Month-over-Month change in CTR (percentage points)
  },
  "position": {
    "L7D": number,       // Average position in search results for the Last 7 Days
    "L30D": number,      // Average position in search results for the Last 30 Days
    "WoW Change": number, // Week-over-Week change in position (negative change is improvement)
    "MoM Change": number  // Month-over-Month change in position (negative change is improvement)
  }
}
  • Query Page Breakdown: Shows how specific queries perform for specific pages

{
  "queries": [  // Array of query objects
    {
      "query": "string",     // The specific search query text being analyzed
      "clicks": number,      // Total clicks received from this query across all pages
      "impressions": number, // Total impressions for this query across all pages
      "ctr": number,         // Overall click-through rate for the query (expressed as percentage)
      "position": number,    // Average position in search results for this query
      
      "ranking_pages": [     // Array of pages that rank for this query
        {
          "url": "string",   // Full URL of the ranking page
          "clicks": number,  // Number of clicks this specific page received for this query
          "impressions": number, // Number of impressions this page received for this query
          "ctr": number,     // Page-specific click-through rate (expressed as decimal)
          "position": number, // Average position of this page for this query
          "clicks_percent_total": number, // Percentage of total query clicks going to this page
          "impressions_percent_total": number // Percentage of total query impressions going to this page
        }
        // Multiple page objects will be returned, sorted by clicks in descending order
      ]
    },
    // Multiple query objects will be returned, typically sorted by clicks in descending order
  ],
  
  "metadata": {
    "start_date": "string", // ISO format date marking the beginning of the reporting period
    "end_date": "string",   // ISO format date marking the end of the reporting period
    "queries": number,      // Total number of unique queries analyzed in this report
    "urls": number          // Total number of unique URLs that appeared in search results
  }
}
  • Indexing Status: Returns whether a page is indexed, along with the last crawl date in the following JSON format

{
  "last_crawled_at": "string", // Timestamp of the last crawl
  "indexed": boolean           // Whether the page is indexed
}