{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Trends Scraper & API - Trending Now & Trending Searches",
    "description": "Daily and real time trending searches from Google Trends Trending Now, with search volume (100+ countries): active vs ended trends, trend duration. Keywords mode: interest over time, by region, related queries (rising, breakouts). Google Trends API and pytrends alternative. $0.01/run + $0.0005/item.",
    "version": "0.1",
    "x-build-id": "P1pI0L51SbWjCIWC9"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/orbots~google-trends-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-orbots-google-trends-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/orbots~google-trends-scraper/runs": {
      "post": {
        "operationId": "runs-sync-orbots-google-trends-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/orbots~google-trends-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-orbots-google-trends-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": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "What to scrape",
            "enum": [
              "trending",
              "keywords"
            ],
            "type": "string",
            "description": "Trending Now = the searches trending right now in each country or sub-region you pick, read from the public Trending Now page of Google Trends, with estimated search volume; this mode works on the default proxy. Keywords = interest over time, interest by region and (optional) related queries for terms you choose, compared 5 at a time; this mode runs on residential proxy from the country in the Country field by default, because Google refused datacenter addresses on keyword queries in our tests. A run that collects nothing is not charged at all.",
            "default": "trending"
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Search terms to analyse in keywords mode. Google compares up to 5 terms at a time; longer lists are split automatically into groups of 5. With all three data types, one country and 12 months, about 150 terms fit in the default 1-hour run timeout: split longer lists or raise the timeout. Keywords mode uses residential proxy from the country in the Country field by default (see Proxy). Required in keywords mode.",
            "items": {
              "type": "string"
            }
          },
          "geo": {
            "title": "Country",
            "type": "string",
            "description": "Country code (such as US, GB, BR, DE, IN) or a sub-region code for a more local list: US-CA, US-NY, FR-75, GB-ENG, BR-SP. Leave empty for worldwide.",
            "default": "US"
          },
          "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": "Time window for keyword analysis. Each point of the curve is one result, at the spacing Google uses: about 53 weekly points per term over the past 12 months and about 262 over the past 5 years; the past 30 or 90 days are daily, the past 7 days hourly, and the past day or hours in steps of minutes.",
            "default": "today 12-m"
          },
          "property": {
            "title": "Search property (keywords mode)",
            "enum": [
              "web",
              "images",
              "news",
              "youtube",
              "shopping"
            ],
            "type": "string",
            "description": "Which Google surface to measure interest on: regular Web Search, Image Search, News, YouTube or Shopping. Same 0-100 scale, filtered to that property.",
            "default": "web"
          },
          "dataTypes": {
            "title": "Data to return",
            "type": "array",
            "description": "Which blocks to collect in Keywords mode. Fewer blocks = fewer results = lower cost. Related queries is off by default: it adds up to 25 top and 25 rising queries per term, charged as regular results.",
            "items": {
              "type": "string",
              "enum": [
                "interest_over_time",
                "interest_by_region",
                "related_queries"
              ],
              "enumTitles": [
                "Interest over time",
                "Interest by region",
                "Related queries (top and rising)"
              ]
            },
            "default": [
              "interest_over_time",
              "interest_by_region"
            ]
          },
          "trendingGeos": {
            "title": "Countries (trending mode)",
            "type": "array",
            "description": "One or more country or sub-region codes to pull Trending Now for, e.g. [\"US\",\"BR\",\"US-CA\"]. Defaults to the Country field above.",
            "items": {
              "type": "string"
            }
          },
          "trendingHours": {
            "title": "Trending window",
            "enum": [
              "4",
              "24",
              "48",
              "168"
            ],
            "type": "string",
            "description": "How far back Trending Now looks. Each trend in the window is one result: in the US the 24-hour list held 341 to 898 terms in our daily runs from 2026-10-06 to 2026-11-05, and the 7-day list about 2,600.",
            "default": "24"
          },
          "categories": {
            "title": "Categories (trending mode)",
            "type": "array",
            "description": "Keep only trends in these Google topic categories: the same 19 categories Google itself assigns to each trend (such as Sports and Entertainment). Empty = all categories. A trend Google did not categorise is excluded whenever this filter is set.",
            "items": {
              "type": "string",
              "enum": [
                "Autos and Vehicles",
                "Beauty and Fashion",
                "Business and Finance",
                "Climate",
                "Entertainment",
                "Food and Drink",
                "Games",
                "Health",
                "Hobbies and Leisure",
                "Jobs and Education",
                "Law and Government",
                "Other",
                "Pets and Animals",
                "Politics",
                "Science",
                "Shopping",
                "Sports",
                "Technology",
                "Travel and Transportation"
              ],
              "enumTitles": [
                "Autos and Vehicles",
                "Beauty and Fashion",
                "Business and Finance",
                "Climate",
                "Entertainment",
                "Food and Drink",
                "Games",
                "Health",
                "Hobbies and Leisure",
                "Jobs and Education",
                "Law and Government",
                "Other",
                "Pets and Animals",
                "Politics",
                "Science",
                "Shopping",
                "Sports",
                "Technology",
                "Travel and Transportation"
              ]
            },
            "default": []
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Response language, e.g. en-US, pt-BR, de-DE.",
            "default": "en-US"
          },
          "onlyNew": {
            "title": "Only new trends since the last run (trending mode)",
            "type": "boolean",
            "description": "Built for schedules. The Actor remembers what it already delivered for each country and window, and returns only trends it has not sent you before, so runs that overlap (a 7-day window pulled daily, or a 24-hour window pulled every few hours) do not charge you twice for the same trend. Two 24-hour lists pulled a day apart barely overlap, so on that schedule it changes little. A term that trends again later counts as new. History is kept for 7 days, per country and window, in your own account. Leave off to always get the full list.",
            "default": false
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 1,
            "type": "integer",
            "description": "Hard cap on results. The Actor stops at exactly this number and never charges beyond it. Leave empty for no cap."
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Google rate-limits by IP, so keep a proxy on. In keywords mode the default setting is replaced by Apify residential proxy from the country in the Country field; any other setting you choose here is used as is. Trending mode works on the default datacenter proxy.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}