{
  "openapi": "3.0.1",
  "info": {
    "title": "Google AI Overview Scraper & Tracker: Full Answer",
    "description": "The full Google AI Overview (also the hidden \"Show more\" part) as text and Markdown, every source with its real URL, products, and your brand: mentioned, cited, organic rank, new or lost since last run. Any country and city. Pay only when an AI Overview is found: $4.99/1K.",
    "version": "0.1",
    "x-build-id": "CJeMg1UQPcNVmANj6"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/s_actors~google-ai-overview-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-s_actors-google-ai-overview-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/s_actors~google-ai-overview-scraper/runs": {
      "post": {
        "operationId": "runs-sync-s_actors-google-ai-overview-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/s_actors~google-ai-overview-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-s_actors-google-ai-overview-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "queries": {
            "title": "🔎 Search queries",
            "type": "array",
            "description": "Questions and keywords exactly as people type them into Google, one per line: \"best crm for small business\", \"is coffee good for you\", \"hubspot vs salesforce\". Each query is one Google search; you pay only when Google shows an AI Overview for it. You can also paste a Google search URL (https://www.google.com/search?q=...).",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "🌍 Country",
            "enum": [
              "us",
              "gb",
              "ca",
              "au",
              "nz",
              "ie",
              "in",
              "sg",
              "za",
              "ph",
              "de",
              "at",
              "ch",
              "fr",
              "be",
              "nl",
              "es",
              "pt",
              "it",
              "se",
              "dk",
              "no",
              "fi",
              "pl",
              "cz",
              "br",
              "mx",
              "ar",
              "jp",
              "kr",
              "tr",
              "ae"
            ],
            "type": "string",
            "description": "Google of this country. AI Overviews differ by country (sources, prices, products): every page is checked to really come from this market and retried if Google answered for another one.",
            "default": "us"
          },
          "location": {
            "title": "📍 City",
            "type": "string",
            "description": "Search as if you were in this city: \"Austin, Texas\", \"Manchester, England\", \"Munich, Bavaria\". Empty = the country's largest city (New York for the US, London, Berlin...)."
          },
          "language": {
            "title": "🗣️ Language",
            "type": "string",
            "description": "Google interface language code (hl): en, de, fr, es, pt, it, nl, ja... Empty = the country's main language. The AI Overview is written in this language."
          },
          "brandNames": {
            "title": "🏷️ Your brand names",
            "type": "array",
            "description": "Names to look for in the answer text and in the products it recommends, one per line, other spellings as separate lines (\"HubSpot\", \"Hubspot CRM\"). Whole words, any case. Every row gets brandMentions: mentioned, how many times, the first sentence that mentions it.",
            "items": {
              "type": "string"
            }
          },
          "trackDomains": {
            "title": "🌐 Your domains",
            "type": "array",
            "description": "Your sites, one per line: \"hubspot.com\". For each query: is the domain cited as an AI Overview source (and at which position), how many statements of the answer it backs, its organic position on the same result page, and new / lost since the last run. Subdomains count (blog.hubspot.com).",
            "items": {
              "type": "string"
            }
          },
          "competitors": {
            "title": "🥊 Competitors",
            "type": "array",
            "description": "Competitor names or domains, one per line. A name (\"Pipedrive\") is looked for in the answer and in the cited sources; a domain (\"zoho.com\") is also checked as a source and in the organic results, and its name (\"zoho\") is looked for in the answer.",
            "items": {
              "type": "string"
            }
          },
          "historyName": {
            "title": "📁 Project name (history)",
            "type": "string",
            "description": "Where the Actor keeps the sources of this run to compare them next time (changes.sourcesAdded / sourcesRemoved, trackedDomains[].status new / lost). Use one name per brand or client so their histories never mix.",
            "default": "default"
          },
          "includeOrganicResults": {
            "title": "📄 Include organic results",
            "type": "boolean",
            "description": "Also return the ~10 organic results of the same page (position, title, real URL, snippet). Free: the page is read anyway. Positions of your domains and competitors are given either way.",
            "default": false
          },
          "maxConcurrency": {
            "title": "⚡ Parallel queries",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Queries searched at once.",
            "default": 5
          },
          "debugLog": {
            "title": "🐞 Debug log",
            "type": "boolean",
            "description": "Log every retry and save the HTML of every result page to the run key-value store.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}