{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Trends Trending Now Scraper — Daily Trends by Country",
    "description": "Export Google Trends 'Trending Now' searches for any country and time window (4h–7d): keyword, approximate search volume, start time, categories and related queries. Also keyword interest-over-time reports. $0.50 per 1,000 trends on the Free plan, plus platform usage.",
    "version": "0.1",
    "x-build-id": "JQSB85hE7DItt6kRh"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/peerless_columbine~google-trends-scraper-api/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-peerless_columbine-google-trends-scraper-api",
        "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/peerless_columbine~google-trends-scraper-api/runs": {
      "post": {
        "operationId": "runs-sync-peerless_columbine-google-trends-scraper-api",
        "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/peerless_columbine~google-trends-scraper-api/run-sync": {
      "post": {
        "operationId": "run-sync-peerless_columbine-google-trends-scraper-api",
        "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": {
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Keyword mode only (ignored when `mode` is `trending`). One Google Trends search term per entry; each entry becomes one report row (interest over time, by region, related queries/topics). With `isMultiple` true, an entry like `iphone, samsung` is compared in one request (max 5 terms per group; longer lists are split into groups of 5). Can be combined with `startUrls` and `spreadsheetId`; if all three are empty the Actor uses `ChatGPT`.",
            "items": {
              "type": "string"
            }
          },
          "isMultiple": {
            "title": "Multiple terms",
            "type": "boolean",
            "description": "Keyword mode only. When true, commas inside each `searchTerms` entry separate terms that are compared with each other in one Google Trends request (max 5 per comparison; extra terms start a new group). When false (default), each entry is one term even if it contains commas. Not supported with `outputSchema` = `data-xplorer`; comparisons need native output.",
            "default": false
          },
          "timeRange": {
            "title": "Time range",
            "type": "string",
            "description": "Keyword mode only. Predefined Google Trends time window, as Google's own code. Empty = past 12 months. Accepted values: `now 1-H` (past hour), `now 4-H` (4 hours), `now 1-d` (day), `now 7-d` (7 days), `today 1-m` (30 days), `today 3-m` (90 days), `today 12-m` (12 months), `today 5-y` (5 years), `all` (2004 to present). Ignored when `customTimeRange` is set. Example: `today 3-m`."
          },
          "geo": {
            "title": "Geo area",
            "type": "string",
            "description": "Keyword mode: the region the interest data is for. Two-letter ISO country code (e.g. `US`, `DE`), a subdivision such as `US-CA`, or empty for Worldwide. A `geo` parameter inside a start URL wins for that URL. In trending mode it is used as the country only when `trendingSearchesCountry` is empty. Region/city/metro breakdowns depend on what Google provides.",
            "default": ""
          },
          "category": {
            "title": "Category ID",
            "type": "string",
            "description": "Keyword mode only. Google Trends category ID as a string; empty or `0` = all categories. Named options: `3` Arts & Entertainment, `47` Autos, `12` Business, `5` Computers & Electronics, `7` Finance, `71` Food & Drink, `8` Games, `45` Health, `16` News, `18` Shopping, `20` Sports, `67` Travel (and more); any other numeric Google Trends category ID also works. Example: `5`.",
            "default": ""
          },
          "startUrls": {
            "title": "Google Trends URLs",
            "type": "array",
            "description": "Keyword mode only; alternative or addition to `searchTerms`. Google Trends Explore URLs. Their `q` (comma-separated terms are compared, max 5 per group), `geo`, `date`, `cat` and `gprop` parameters override the form settings for that URL. Example: `https://trends.google.com/trends/explore?q=bitcoin&geo=US&date=today%203-m`.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "spreadsheetId": {
            "title": "Public Google Sheet ID or URL",
            "type": "string",
            "description": "Keyword mode only; alternative or addition to `searchTerms`. ID or full URL of a public Google Sheet (shared as 'anyone with the link can view'). Only the first column of the first sheet is read: row 1 is treated as a header and skipped, every following non-empty cell becomes one search term. Example: `https://docs.google.com/spreadsheets/d/<sheetId>/edit` or just the `<sheetId>` part."
          },
          "requestDelayMillis": {
            "title": "Minimum request spacing",
            "minimum": 0,
            "maximum": 2000,
            "type": "integer",
            "description": "Leave at 0 unless Google rate-limits you. Minimum gap in milliseconds between the starts of Google Trends HTTP requests, shared across all parallel workers. Allowed range: 0–2000.",
            "default": 0
          },
          "viewedFrom": {
            "title": "Compatibility: viewedFrom",
            "type": "string",
            "description": "Advanced, usually leave empty. Two-letter country code (e.g. `us`, `de`) for the proxy exit location, i.e. where Google sees the request coming from. This is not the data region (use `geo` for that). Requires Apify RESIDENTIAL proxy access (extra cost); combining it with disabled or custom proxy URLs in `proxyConfiguration` fails with an input error. Example: `us`."
          },
          "mode": {
            "title": "mode",
            "enum": [
              "keyword",
              "trending"
            ],
            "type": "string",
            "description": "What to collect. `keyword` (default): historical interest reports for `searchTerms` / `startUrls` / `spreadsheetId`, using `timeRange`, `geo` and `category`. `trending`: Google's live 'Trending Now' list for one country, using the `trendingSearches*` fields; keyword fields are ignored. Use `trending` to find what is spiking now, `keyword` to measure interest in terms you already know.",
            "default": "keyword"
          },
          "keyword": {
            "title": "keyword",
            "type": "string",
            "description": "Keyword mode only. Shortcut for one search term; used only when `searchTerms` is empty. Example: `bitcoin`."
          },
          "predefinedTimeframe": {
            "title": "predefinedTimeframe",
            "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": "Alias of `timeRange`, used only when `timeRange` is empty; leave empty and use `timeRange`. Same Google codes: `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`. Example: `today 5-y`."
          },
          "trendingSearchesCountry": {
            "title": "trendingSearchesCountry",
            "enum": [
              "US",
              "FR",
              "AL",
              "DZ",
              "AO",
              "AR",
              "AM",
              "AU",
              "AT",
              "AZ",
              "BH",
              "BD",
              "BY",
              "BE",
              "BJ",
              "BO",
              "BA",
              "BR",
              "BG",
              "BF",
              "KH",
              "CM",
              "CA",
              "CL",
              "CO",
              "CR",
              "HR",
              "CU",
              "CY",
              "CZ",
              "CD",
              "DK",
              "DO",
              "EC",
              "EG",
              "SV",
              "EE",
              "ET",
              "FI",
              "GE",
              "DE",
              "GH",
              "GR",
              "GT",
              "HT",
              "HN",
              "HK",
              "HU",
              "IN",
              "ID",
              "IR",
              "IQ",
              "IE",
              "IL",
              "IT",
              "CI",
              "JM",
              "JP",
              "JO",
              "KZ",
              "KE",
              "KW",
              "KG",
              "LV",
              "LB",
              "LY",
              "LT",
              "MY",
              "ML",
              "MX",
              "MD",
              "MA",
              "MZ",
              "MM",
              "NP",
              "NL",
              "NZ",
              "NI",
              "NG",
              "MK",
              "NO",
              "OM",
              "PK",
              "PS",
              "PA",
              "PY",
              "PE",
              "PH",
              "PL",
              "PT",
              "PR",
              "QA",
              "RO",
              "RU",
              "SA",
              "SN",
              "RS",
              "SG",
              "SK",
              "SI",
              "ZA",
              "KR",
              "ES",
              "LK",
              "SE",
              "CH",
              "SY",
              "TW",
              "TZ",
              "TH",
              "TT",
              "TN",
              "TR",
              "TM",
              "UG",
              "UA",
              "AE",
              "GB",
              "UY",
              "UZ",
              "VE",
              "VN",
              "YE",
              "ZM",
              "ZW"
            ],
            "type": "string",
            "description": "Trending mode only. Two-letter country code (uppercase) whose Google 'Trending Now' list to fetch, e.g. `US`, `GB`, `IN`, `DE`, `JP`, `BR`; must be one of the listed codes. If empty, `geo` is used, then `US`."
          },
          "trendingSearchesTimeframe": {
            "title": "trendingSearchesTimeframe",
            "enum": [
              "4",
              "24",
              "48",
              "168"
            ],
            "type": "string",
            "description": "Trending mode only. Look-back window in hours, given as a string. Accepted values: `4`, `24`, `48`, `168` (7 days). Empty = `24`."
          },
          "trendingSearchesCategories": {
            "title": "trendingSearchesCategories",
            "type": "array",
            "description": "Trending mode only. Optional filter: keep only trends tagged with at least one of these Google Trending Now category IDs (strings). Empty = all. IDs: 1 Autos, 2 Beauty & Fashion, 3 Business & Finance, 4 Entertainment, 5 Food & Drink, 6 Games, 7 Health, 8 Hobbies, 9 Jobs & Education, 10 Law & Government, 11 Other, 13 Pets, 14 Politics, 15 Science, 16 Shopping, 17 Sports, 18 Technology, 19 Travel, 20 Climate. Example: `[\"17\", \"18\"]`.",
            "items": {
              "type": "string"
            }
          },
          "trendingSearchesMaxItems": {
            "title": "trendingSearchesMaxItems",
            "type": "integer",
            "description": "Trending mode only. Maximum number of trending searches to return, 1–1000 (applied after the category filter). If empty, `maxItems` is used, and if that is 0 too, 50. Example: `25`."
          },
          "fetchRegionalData": {
            "title": "Fetch Regional Data",
            "type": "boolean",
            "description": "Keyword mode only. When true (default), also fetch interest by country/region/city (plus metro areas for US-state geos such as `US-CA`). Set false for faster runs that only need the timeline and related queries/topics.",
            "default": true
          },
          "dataXplorerInput": {
            "title": "Data Xplorer compatibility input",
            "type": "object",
            "description": "Advanced, leave empty: migration input for users of the data_xplorer Google Trends Actor. If set, ALL settings go inside this object with the same field names, e.g. `{\"mode\":\"keyword\",\"keyword\":\"Python\",\"geo\":\"US\"}`; other top-level fields must be absent or at their defaults or the run fails. Missing values take that Actor's defaults (trending mode, keyword `bitcoin`, country `US`, 24 hours, no regional data)."
          },
          "maxItems": {
            "title": "Maximum report rows",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Keyword mode: maximum number of report rows (one per search term or comparison group); extra terms are skipped. Trending mode: used as the number of trending searches when `trendingSearchesMaxItems` is empty. 0 = no limit (trending mode then returns up to 50). Allowed range: 0–1000.",
            "default": 0
          },
          "maxRequestRetries": {
            "title": "Maximum request retries",
            "minimum": 0,
            "maximum": 8,
            "type": "integer",
            "description": "Leave default unless runs fail intermittently. Retries per request for network errors and HTTP 403/408/429/5xx responses. Allowed range: 0–8.",
            "default": 4
          },
          "rateLimitRecoverySeconds": {
            "title": "429 recovery wait",
            "minimum": 0,
            "maximum": 120,
            "type": "integer",
            "description": "Leave default. Seconds to wait before each extra retry round for searches Google rate-limited (HTTP 429) when no proxy is available; if an Apify proxy is available the round switches to it immediately. 0 = no wait. Allowed range: 0–120.",
            "default": 30
          },
          "rateLimitRecoveryRounds": {
            "title": "Maximum 429 recovery rounds",
            "minimum": 0,
            "maximum": 3,
            "type": "integer",
            "description": "Leave default. Number of extra retry rounds, after the main pass, for searches that are still rate-limited (HTTP 429). Each round retries only those searches. 0 disables them. Allowed range: 0–3.",
            "default": 2
          },
          "customTimeRange": {
            "title": "Custom time range",
            "type": "string",
            "description": "Keyword mode only. Exact date range: start and end date separated by one space, format `YYYY-MM-DD YYYY-MM-DD`. Overrides `timeRange`. Leave empty to use `timeRange`. Example: `2024-01-01 2024-12-31`."
          },
          "proxyConfiguration": {
            "title": "Proxy connection (optional)",
            "type": "object",
            "description": "Apify proxy settings. With a proxy enabled (the default when omitted from API input), every request goes through it from the start; proxy traffic can add platform cost. `{\"useApifyProxy\": false}` sends requests directly with no proxy, which is usually enough for small runs. Example: `{\"useApifyProxy\": false}`.",
            "default": {
              "useApifyProxy": true
            }
          },
          "maxConcurrency": {
            "title": "Maximum concurrency",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Leave default. Number of search terms / comparison groups fetched in parallel. Higher is faster but more likely to be rate-limited by Google. Allowed range: 1–10.",
            "default": 4
          },
          "pageLoadTimeoutSecs": {
            "title": "Request timeout seconds",
            "minimum": 5,
            "maximum": 180,
            "type": "integer",
            "description": "Leave default. Timeout in seconds for each Google Trends HTTP request (also used for the Google Sheet download and optional snapshots). Allowed range: 5–180.",
            "default": 30
          },
          "skipDebugScreen": {
            "title": "Compatibility: skipDebugScreen",
            "type": "boolean",
            "description": "Leave true (default). Set false only for debugging: after the data is saved, each requested Explore or Trending page is opened in headless Chromium and a PNG screenshot plus HTML copy are stored in the run's key-value store (slower, more compute). Snapshot failures do not affect the dataset.",
            "default": true
          },
          "enableTrendingSearches": {
            "title": "Legacy trending mode switch",
            "type": "boolean",
            "description": "Advanced, leave unset: legacy alias for `mode`. If set, it overrides `mode`: true = `trending`, false = `keyword`."
          },
          "outputSchema": {
            "title": "Output format",
            "enum": [
              "native",
              "data-xplorer"
            ],
            "type": "string",
            "description": "Row format. `native` (default when empty): one detailed row per keyword report or per trending search. `data-xplorer`: rows shaped like the data_xplorer Actor (keyword reports with `timeline_data`/`region_data`; in trending mode one single row holding a `trending_searches` array, billed as one result). `data-xplorer` does not support multi-term comparisons. Accepted values: `native`, `data-xplorer`. Example: `native`."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}