{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Trends Scraper: Reliable & Fast",
    "description": "Scrape Google Trends: interest over time, by region and related queries for up to 5 compared keywords, plus Trending Now. Fast runs, no timeouts.",
    "version": "1.0",
    "x-build-id": "GKInLpDdPJakL6Ji4"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/cylindrical_lighthouse~google-trends/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-cylindrical_lighthouse-google-trends",
        "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/cylindrical_lighthouse~google-trends/runs": {
      "post": {
        "operationId": "runs-sync-cylindrical_lighthouse-google-trends",
        "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/cylindrical_lighthouse~google-trends/run-sync": {
      "post": {
        "operationId": "run-sync-cylindrical_lighthouse-google-trends",
        "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": {
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Search terms to look up. Each keyword gets its own report on its own 0–100 scale. You can also use a Google Knowledge Graph topic ID, e.g. \"/m/09gbxjr\". To put terms on one shared scale, use \"Comparisons\" instead. Example: [\"coffee\", \"tea\"].",
            "items": {
              "type": "string"
            }
          },
          "comparisons": {
            "title": "Comparisons (up to 5 terms each)",
            "type": "array",
            "description": "Groups of 2–5 comma-separated terms compared on one shared 0–100 scale, exactly like typing them into Google Trends together. Each group returns one report per term, and each report lists the others in \"comparedWith\". Example: [\"coffee, tea, matcha\", \"iphone, pixel\"].",
            "items": {
              "type": "string"
            }
          },
          "geos": {
            "title": "Locations",
            "type": "array",
            "description": "Where to measure interest. Use a country code (\"US\", \"GB\", \"DE\"), a region (\"US-CA\", \"GB-SCT\"), a US metro area (\"US-NY-501\") or \"worldwide\". Leave empty for worldwide. Every keyword and comparison runs once per location. Example: [\"US\", \"GB\"].",
            "items": {
              "type": "string"
            }
          },
          "timeframe": {
            "title": "Time range",
            "enum": [
              "now 1-H",
              "now 4-H",
              "now 1-d",
              "now 7-d",
              "today 1-m",
              "today 3-m",
              "today 12-m",
              "today 5-y",
              "all"
            ],
            "type": "string",
            "description": "The period to cover. Shorter ranges give finer granularity: past hour/4 hours = by minute, past day = 8-minute steps, past 7 days = hourly, 1–3 months = daily, 12 months–5 years = weekly, 2004–present = monthly. Ignored when \"Custom time range\" is set. Example: \"today 12-m\".",
            "default": "today 12-m"
          },
          "customTimeRange": {
            "title": "Custom time range",
            "pattern": "^(\\s*|\\d{4}-\\d{2}-\\d{2}\\s+\\d{4}-\\d{2}-\\d{2})$",
            "type": "string",
            "description": "Optional exact date range as \"YYYY-MM-DD YYYY-MM-DD\" (UTC), from 2004-01-01 to today. Overrides \"Time range\". Up to ~9 months gives daily points; longer ranges give weekly or monthly points. Example: \"2024-01-01 2024-06-30\"."
          },
          "property": {
            "title": "Search type",
            "enum": [
              "",
              "images",
              "news",
              "froogle",
              "youtube"
            ],
            "type": "string",
            "description": "Which Google search to measure: web search (default), image search, news search, Google Shopping or YouTube search. Example: \"youtube\".",
            "default": ""
          },
          "category": {
            "title": "Category ID",
            "minimum": 0,
            "type": "integer",
            "description": "Narrow results to a Google Trends category. 0 = all categories. Common IDs: 3 Arts & Entertainment, 5 Computers & Electronics, 7 Finance, 8 Games, 12 Business & Industrial, 13 Internet & Telecom, 16 News, 18 Shopping, 20 Sports, 29 Real Estate, 44 Beauty & Fitness, 45 Health, 47 Autos & Vehicles, 67 Travel, 71 Food & Drink, 174 Science, 958 Jobs & Education. The README links the full list. Example: 7.",
            "default": 0
          },
          "includeInterestOverTime": {
            "title": "Interest over time",
            "type": "boolean",
            "description": "Include the timeline of 0–100 interest values (field \"interestOverTime\"), plus average, peak and latest values. Example: true.",
            "default": true
          },
          "includeInterestByRegion": {
            "title": "Interest by region",
            "type": "boolean",
            "description": "Include the 0–100 interest per country, region, metro or city (field \"interestByRegion\"). Example: true.",
            "default": true
          },
          "includeRelatedQueries": {
            "title": "Related queries",
            "type": "boolean",
            "description": "Include the top and rising related search queries, with \"Breakout\" flags (field \"relatedQueries\"). Example: true.",
            "default": true
          },
          "regionResolution": {
            "title": "Region level",
            "enum": [
              "AUTO",
              "COUNTRY",
              "REGION",
              "DMA",
              "CITY"
            ],
            "type": "string",
            "description": "The level of \"Interest by region\". AUTO uses Google's default: countries for worldwide, regions (states) for a country, metros for a region. Metro (DMA) and city levels work for US locations and some other countries. If Google does not offer the level for a location, the default is used and a warning is logged. Example: \"CITY\".",
            "default": "AUTO"
          },
          "includeLowVolumeRegions": {
            "title": "Include low-volume regions",
            "type": "boolean",
            "description": "Also list regions where Google has too little search volume to show a value. Their \"value\" is null. Off by default, so only regions with data are returned. Example: false.",
            "default": false
          },
          "trendingNowGeos": {
            "title": "Trending Now: countries",
            "type": "array",
            "description": "Fetch the live Trending Now list (what people are searching for right now) for these country codes. Each trend includes search volume, % increase, start and end time, related breakdown queries and categories. Leave empty to skip. Example: [\"US\", \"GB\"].",
            "items": {
              "type": "string"
            }
          },
          "trendingNowHours": {
            "title": "Trending Now: time window",
            "enum": [
              "4",
              "24",
              "48",
              "168"
            ],
            "type": "string",
            "description": "How far back Trending Now looks: past 4 hours, 24 hours, 48 hours or 7 days. Example: \"24\".",
            "default": "24"
          },
          "trendingNowCategory": {
            "title": "Trending Now: category",
            "enum": [
              "0",
              "1",
              "2",
              "3",
              "4",
              "5",
              "6",
              "7",
              "8",
              "9",
              "10",
              "11",
              "13",
              "14",
              "15",
              "16",
              "17",
              "18",
              "19",
              "20"
            ],
            "type": "string",
            "description": "Only return trends in this category. Example: \"17\" (Sports).",
            "default": "0"
          },
          "trendingNowActiveOnly": {
            "title": "Trending Now: active trends only",
            "type": "boolean",
            "description": "Only return trends that are still active (no end time yet). Example: false.",
            "default": false
          },
          "maxTrendingNowItemsPerGeo": {
            "title": "Trending Now: max trends per country",
            "minimum": 0,
            "type": "integer",
            "description": "The most trends to return per country, ranked as on trends.google.com. 0 = all (usually 200–450). Example: 25.",
            "default": 25
          },
          "maxItems": {
            "title": "Maximum results",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many results in total (keyword reports + trending items). Keeps the cost predictable. 0 = no limit. Example: 100.",
            "default": 1000
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Language for region names and Trending Now, as a code like \"en-US\", \"de\" or \"pt-BR\". It does not filter which searches are counted. Example: \"en-US\".",
            "default": "en-US"
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify Proxy settings. The default (datacenter proxy with automatic IP rotation) works reliably and is included in the price. You do not need to change this. Example: {\"useApifyProxy\": true}.",
            "default": {
              "useApifyProxy": true
            }
          },
          "residentialFallback": {
            "title": "Residential fallback",
            "type": "boolean",
            "description": "If Google blocks every datacenter IP tried for a query, retry that query once more through residential proxies. It is included in the price at no extra cost. Example: true.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}