Pricing
$12.00/month + usage
Fastest and Cheapest Google Trends Scraper: All in one, 🔥real time trending searches, interest over time, interest by region, and related Trending now, and more
0.0 (0)
Pricing
$12.00/month + usage
0
1
1
Last modified
2 minutes ago
You can access the Google Trends Scraper 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 Integrations settings in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.1", "x-build-id": "Fhy7AvOgEIRgXNcLM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraperpro~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraperpro-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/scraperpro~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-scraperpro-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/scraperpro~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-scraperpro-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", "properties": { "scrape_type": { "title": "Scrape Type", "enum": [ "trending_now", "interest_over_time", "interest_by_region", "related_queries", "related_topics", "trending_searches" ], "type": "string", "description": "What to retrieve from Google Trends.", "default": "trending_now" }, "keywords": { "title": "Keywords", "type": "array", "description": "Keywords to analyze. Required for all types except 'trending_now'. For 'related_*', only the first keyword is used.", "items": { "type": "string" } }, "gprop": { "title": "Google Trends Property", "enum": [ "web", "images", "news", "froogle", "youtube" ], "type": "string", "description": "Google Property Filter. ex Images, Youtube, images, news, shopping", "default": "web" }, "timeframe_type": { "title": "Timeframe Type", "enum": [ "predefined", "custom" ], "type": "string", "description": "Use a predefined timeframe or a custom range.", "default": "predefined" }, "predefined_timeframe": { "title": "Predefined Timeframe", "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": "Common timeframes used by Google Trends.", "default": "today 12-m" }, "custom_timeframe": { "title": "Custom Timeframe", "type": "string", "description": "Custom date range (e.g., '2023-01-01 2023-06-30') or hourly (e.g., '2024-03-01T00 2024-03-03T12'). If empty and 'custom' is selected, the actor will fallback to the predefined timeframe." }, "geo_selection_type": { "title": "Geographic Selection Type", "enum": [ "Common Countries", "Custom Geo Code" ], "type": "string", "description": "Choose between a common country code or a custom geo code.", "default": "Common Countries" }, "common_geo": { "title": "Common Country (2-letter code)", "type": "string", "description": "Two-letter country code like 'US', 'GB', 'DE'. Leave empty for global (where applicable).", "default": "US" }, "custom_geo_code": { "title": "Custom Geo Code", "type": "string", "description": "Specific geo code (e.g., 'US-CA' for California).", "default": "" }, "geo_resolution": { "title": "Geographic Resolution (for interest_by_region)", "enum": [ "COUNTRY", "REGION", "DMA", "CITY" ], "type": "string", "description": "Controls the level of geographic detail.", "default": "COUNTRY" }, "inc_low_vol": { "title": "Include Low Volume Regions (interest_by_region)", "type": "boolean", "description": "Include regions with low search volume. Recommended for Pro plan.", "default": false }, "trending_language": { "title": "Trending Now: Language", "type": "string", "description": "Language code for realtime trending (e.g., 'en', 'es').", "default": "en" }, "trending_hours": { "title": "Trending Now: Hours", "minimum": 1, "maximum": 191, "type": "integer", "description": "Time window (1-191 hours) for realtime trending. For larger windows, Pro plan recommended.", "default": 24 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify Proxy or your own proxies to reduce blocks and increase reliability." } } }, "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 } } }, "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 } } } } } } } } }}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 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: