{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Autocomplete Scraper: Keywords, Questions, YouTube",
    "description": "Google Autocomplete keyword suggestions for any country and language, from web search, YouTube, Shopping, Images or News. Expand keywords with A-Z, numbers, questions, prepositions and comparisons in 7 languages, with Google's relevance score. Long-tail ideas for SEO and ads. Duplicates are free.",
    "version": "0.1",
    "x-build-id": "ce4KohZjJIfgqSLqp"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/clearpull~google-autocomplete-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-clearpull-google-autocomplete-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/clearpull~google-autocomplete-scraper/runs": {
      "post": {
        "operationId": "runs-sync-clearpull-google-autocomplete-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/clearpull~google-autocomplete-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-clearpull-google-autocomplete-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": [
          "keywords"
        ],
        "properties": {
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Seed keywords, one per line. Each one is typed into Google's search box the way a person would, and you get what Google suggests. Up to 1,000 per run.",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Two-letter country codes such as US, GB or DE. Suggestions differ by country; each keyword is looked up once per country. Up to 25.",
            "items": {
              "type": "string"
            },
            "default": [
              "US"
            ]
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "The search language, for example en, de, es, pt-BR or ja. Question and preposition expansion has its own words for en, de, fr, es, pt, it and nl, and uses English words for other languages.",
            "default": "en"
          },
          "service": {
            "title": "Google service",
            "enum": [
              "web",
              "youtube",
              "shopping",
              "images",
              "news"
            ],
            "type": "string",
            "description": "Which Google search box to ask. YouTube, Shopping, Images and News each suggest different keywords from web search.",
            "default": "web"
          },
          "expandAlphabet": {
            "title": "A to Z",
            "type": "boolean",
            "description": "Also look up the keyword followed by each letter: \"coffee maker a\" to \"coffee maker z\". 26 more lookups per keyword, usually 330 to 380 more suggestions.",
            "default": false
          },
          "expandNumbers": {
            "title": "0 to 9",
            "type": "boolean",
            "description": "Also look up the keyword followed by each digit: \"coffee maker 0\" to \"coffee maker 9\". Good for models, sizes and years. 10 more lookups per keyword, usually 75 to 145 more suggestions.",
            "default": false
          },
          "expandQuestions": {
            "title": "Questions",
            "type": "boolean",
            "description": "Also look up question words before the keyword: how, what, why, where, when, who, which, can, is, are, does, should and will (or the same words in your language). Great for FAQ and blog ideas.",
            "default": false
          },
          "expandPrepositions": {
            "title": "Prepositions",
            "type": "boolean",
            "description": "Also look up the keyword followed by for, with, without, to, near, in, from, is and can (or the same words in your language).",
            "default": false
          },
          "expandComparisons": {
            "title": "Comparisons",
            "type": "boolean",
            "description": "Also look up the keyword followed by vs, versus, or, and and like, to find the alternatives people compare it with.",
            "default": false
          },
          "customModifiers": {
            "title": "Custom modifiers",
            "type": "array",
            "description": "Optional words of your own, one per line. Each is typed after the keyword (\"2026\" gives \"coffee maker 2026\"), or put {keyword} where the keyword goes (\"best {keyword} for\" gives \"best coffee maker for\"). Up to 50.",
            "items": {
              "type": "string"
            }
          },
          "deduplicate": {
            "title": "Remove duplicates",
            "enum": [
              "run",
              "seed"
            ],
            "type": "string",
            "description": "Across the run: each suggestion appears once per country, even if several of your keywords lead to it, and your own keywords are never returned. Per keyword: each keyword gets its complete list, so a suggestion can appear under more than one keyword.",
            "default": "run"
          },
          "outputFormat": {
            "title": "Output format",
            "enum": [
              "full",
              "compact"
            ],
            "type": "string",
            "description": "Full gives one row per suggestion, with its position, Google's relevance score and the expansion that found it. Compact gives one row per keyword and country with a plain list of suggestions: small enough for AI agents.",
            "default": "full"
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify's datacenter proxy works well and is the default. Google also uses the IP address's location for local suggestions (city names), so for local results pick residential proxies in the same country.",
            "default": {
              "useApifyProxy": true
            }
          },
          "saveRawResponses": {
            "title": "Save Google's raw answers",
            "type": "boolean",
            "description": "For troubleshooting: also store up to 300 of Google's raw answers in the key-value store, under RAW_RESPONSES.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}