Google Trends Scraper — Batch Interest Over Time
Pricing
$0.20 / 1,000 successful keyword results
Batch Google Trends keywords into interest-over-time rows for SEO & content planning. From $0.20 per 1,000 successful keyword results — empty/blocked timelines cost $0. No residential proxy required by default.
You can access the Google Trends Scraper — Batch Interest Over Time programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.1", "x-build-id": "3W7GHI2gVA2n1uIe2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/grokbob~google-trends-batch-ppe/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-grokbob-google-trends-batch-ppe", "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/grokbob~google-trends-batch-ppe/runs": { "post": { "operationId": "runs-sync-grokbob-google-trends-batch-ppe", "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/grokbob~google-trends-batch-ppe/run-sync": { "post": { "operationId": "run-sync-grokbob-google-trends-batch-ppe", "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": "1–N keywords (or short phrases) to fetch interest-over-time for. Each keyword is requested separately so empty/blocked results do not poison the batch.", "items": { "type": "string" } }, "geo": { "title": "Geo", "type": "string", "description": "Google Trends geo code. Empty string = worldwide. Examples: US, GB, DE, FR, IN, BR.", "default": "" }, "timeframe": { "title": "Timeframe", "type": "string", "description": "Google Trends time range. Common values: 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.", "default": "today 12-m" }, "category": { "title": "Category", "minimum": 0, "type": "integer", "description": "Google Trends category ID. 0 = All categories.", "default": 0 }, "includeRelated": { "title": "Include related queries", "type": "boolean", "description": "When true, attach top rising/top related queries to successful keyword rows. Optional PPE event related-pack may apply on Store pricing.", "default": true }, "includeRegion": { "title": "Include interest by region", "type": "boolean", "description": "When true, attach top regions (requires geo empty or a country-level geo). Optional PPE event region-pack may apply. v1 returns a compact top-N list on the summary row.", "default": false }, "includeTimeline": { "title": "Include full timeline on row", "type": "boolean", "description": "When true, embed the full interest-over-time points array on each success row (heavier). Default false — summary stats only.", "default": false }, "maxKeywords": { "title": "Max keywords per run", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap to prevent runaway batches. Excess keywords are skipped with status FAILED reason=maxKeywords.", "default": 50 }, "dryRunMock": { "title": "Dry-run mock (local / CI)", "type": "boolean", "description": "When true, do not call Google. Use built-in mock fixtures (empty vs non-empty) for local smoke tests. Never use in production Store runs.", "default": false }, "useResidentialProxy": { "title": "Use Apify residential proxy (disabled)", "type": "boolean", "description": "IGNORED. Residential sticky / IP-rotate path was stripped (Quality free-fix 2026-09-23, War Room). Always off. 429/captcha → backoff then honest BLOCKED.", "default": false }, "maxAttempts": { "title": "Max attempts per keyword", "minimum": 1, "maximum": 5, "type": "integer", "description": "On soft miss (empty explore/multiline), backoff+jitter and retry up to this many times on the same egress (no proxy rotate). On 429/captcha: honest BLOCKED after the attempt (no IP rotate). Default 3. Cap 5.", "default": 3 } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Google Trends Scraper — Batch Interest Over Time from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: