{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Search Scraper — SERP, Ads, PAA & AI Overview",
    "description": "Scrape Google Search results for any keyword: organic rankings with destination URLs, People Also Ask, related queries, paid ads, AI Overview and knowledge panel. Bulk keywords, any country, language, device, date range and site filter. Export to JSON, CSV or Excel.",
    "version": "1.0",
    "x-build-id": "QiDXGMYfg8FNbgHN7"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/hipersoft~google-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-hipersoft-google-search-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/hipersoft~google-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-hipersoft-google-search-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/hipersoft~google-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-hipersoft-google-search-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",
        "required": [
          "queries"
        ],
        "properties": {
          "queries": {
            "title": "Search queries or Google URLs",
            "type": "array",
            "description": "One or more Google search queries, each scraped separately. You can also paste full Google Search URLs (any country domain) and advanced operators such as site:example.com or \"exact phrase\".",
            "items": {
              "type": "string"
            }
          },
          "resultsPerQuery": {
            "title": "Results per query",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Number of organic results to collect per query, up to 500. You are billed for at most one page per 10 requested results.",
            "default": 10
          },
          "maxPagesPerQuery": {
            "title": "Max pages per query",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "Optional. Collect this many Google pages per query (about 10 results each) instead of a result count. Overrides Results per query."
          },
          "includeSerpFeatures": {
            "title": "Add SERP features (People Also Ask, related, ads, AI Overview, knowledge panel)",
            "type": "boolean",
            "description": "Adds one extra row per query with type \"serp\" holding related queries, People Also Ask questions, paid results, product ads, the AI Overview and the knowledge panel when Google shows them. That row is billed as one result, and only when it has content.",
            "default": false
          },
          "countryCode": {
            "title": "Country",
            "type": "string",
            "description": "Two-letter country code for geolocated results (Google gl parameter), e.g. us, gb, de.",
            "default": "us"
          },
          "languageCode": {
            "title": "Interface language",
            "type": "string",
            "description": "Language of the Google interface (Google hl parameter), e.g. en, es, de, zh-CN.",
            "default": "en"
          },
          "searchLanguage": {
            "title": "Search language",
            "type": "string",
            "description": "Only return pages written in this language (Google lr parameter), e.g. de, fr, ja, zh-CN."
          },
          "googleDomain": {
            "title": "Google domain",
            "type": "string",
            "description": "Google country domain to search, e.g. google.co.uk, google.de, google.com.au. Defaults to google.com."
          },
          "locationUule": {
            "title": "Location hint (UULE)",
            "type": "string",
            "description": "Google UULE location code (Google uule parameter), e.g. w+CAIQICIfU2VhdHRsZSxXYXNoaW5ndG9uLFVuaXRlZCBTdGF0ZXM for Seattle. Google biases results toward the place but does not limit them to it."
          },
          "mobileResults": {
            "title": "Mobile results",
            "type": "boolean",
            "description": "Return the mobile version of the results instead of desktop.",
            "default": false
          },
          "site": {
            "title": "Only this site",
            "type": "string",
            "description": "Limit results to one site, e.g. example.com (adds site:example.com)."
          },
          "relatedToSite": {
            "title": "Related to site",
            "type": "string",
            "description": "Find pages related to a site, e.g. example.com. Ignored when Only this site is set."
          },
          "forceExactMatch": {
            "title": "Exact match",
            "type": "boolean",
            "description": "Search for the exact phrase by wrapping each query in quotes. May return fewer results.",
            "default": false
          },
          "wordsInTitle": {
            "title": "Words in title",
            "type": "array",
            "description": "Only pages with these words in the title (intitle:).",
            "items": {
              "type": "string"
            }
          },
          "wordsInText": {
            "title": "Words in text",
            "type": "array",
            "description": "Only pages with these words in the body text (intext:).",
            "items": {
              "type": "string"
            }
          },
          "wordsInUrl": {
            "title": "Words in URL",
            "type": "array",
            "description": "Only pages with these words in the URL (inurl:).",
            "items": {
              "type": "string"
            }
          },
          "fileTypes": {
            "title": "File types",
            "type": "array",
            "description": "Only files of these types, e.g. pdf, docx, xlsx, csv (filetype:). Several types are combined with OR.",
            "items": {
              "type": "string"
            }
          },
          "quickDateRange": {
            "title": "Quick date range",
            "pattern": "^$|^[hdwmy]\\d*$",
            "type": "string",
            "description": "Only recent results: h, d, w, m or y plus an optional number, e.g. d7 for the past 7 days, w2 for 2 weeks, m6 for 6 months, y1 for a year."
          },
          "afterDate": {
            "title": "After date",
            "type": "string",
            "description": "Only results after this date: an absolute date such as 2026-01-31, or relative such as 8 days or 3 months."
          },
          "beforeDate": {
            "title": "Before date",
            "type": "string",
            "description": "Only results before this date: an absolute date such as 2026-01-31, or relative such as 8 days or 3 months."
          },
          "includeUnfilteredResults": {
            "title": "Unfiltered results",
            "type": "boolean",
            "description": "Include the similar and lower-quality results Google normally hides.",
            "default": false
          },
          "saveHtmlToKeyValueStore": {
            "title": "Save page HTML",
            "type": "boolean",
            "description": "Store the HTML of each results page in the run's key-value store and add a link to it (htmlSnapshotUrl) on each result.",
            "default": false
          },
          "maxConcurrency": {
            "title": "Queries at once",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many queries to run in parallel.",
            "default": 5
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}