{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper — Trending Now & Interest Over Time", "description": "Google Trends scraper and API: Trending Now searches for 125 countries from the official feed (traffic, start time, picture, news articles), plus best-effort interest over time, by region and related queries for your keywords. $0.50 per 1,000 trends; rate-limited parts are free.", "version": "0.1", "x-build-id": "yZU0mokOWH2yYi1LX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/actor-forge~google-trends/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-actor-forge-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/actor-forge~google-trends/runs": { "post": { "operationId": "runs-sync-actor-forge-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/actor-forge~google-trends/run-sync": { "post": { "operationId": "run-sync-actor-forge-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": { "geos": { "title": "Countries", "type": "array", "description": "Countries to read Trending Now for (one request per country). All 125 countries the official feed accepts are listed. Leave empty to only explore keywords.", "items": { "type": "string", "enum": [ "AE", "AL", "AM", "AO", "AR", "AT", "AU", "AZ", "BA", "BD", "BE", "BF", "BG", "BH", "BJ", "BO", "BR", "BY", "CA", "CD", "CH", "CI", "CL", "CM", "CO", "CR", "CU", "CY", "CZ", "DE", "DK", "DO", "DZ", "EC", "EE", "EG", "ES", "ET", "FI", "FR", "GB", "GE", "GH", "GR", "GT", "HK", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IN", "IQ", "IR", "IT", "JM", "JO", "JP", "KE", "KG", "KH", "KR", "KW", "KZ", "LB", "LK", "LT", "LV", "LY", "MA", "MD", "MK", "ML", "MM", "MX", "MY", "MZ", "NG", "NI", "NL", "NO", "NP", "NZ", "OM", "PA", "PE", "PH", "PK", "PL", "PR", "PS", "PT", "PY", "QA", "RO", "RS", "RU", "SA", "SE", "SG", "SI", "SK", "SN", "SV", "SY", "TH", "TM", "TN", "TR", "TT", "TW", "TZ", "UA", "UG", "US", "UY", "UZ", "VE", "VN", "YE", "ZA", "ZM", "ZW" ], "enumTitles": [ "United Arab Emirates (AE)", "Albania (AL)", "Armenia (AM)", "Angola (AO)", "Argentina (AR)", "Austria (AT)", "Australia (AU)", "Azerbaijan (AZ)", "Bosnia & Herzegovina (BA)", "Bangladesh (BD)", "Belgium (BE)", "Burkina Faso (BF)", "Bulgaria (BG)", "Bahrain (BH)", "Benin (BJ)", "Bolivia (BO)", "Brazil (BR)", "Belarus (BY)", "Canada (CA)", "Congo - Kinshasa (CD)", "Switzerland (CH)", "Côte d’Ivoire (CI)", "Chile (CL)", "Cameroon (CM)", "Colombia (CO)", "Costa Rica (CR)", "Cuba (CU)", "Cyprus (CY)", "Czechia (CZ)", "Germany (DE)", "Denmark (DK)", "Dominican Republic (DO)", "Algeria (DZ)", "Ecuador (EC)", "Estonia (EE)", "Egypt (EG)", "Spain (ES)", "Ethiopia (ET)", "Finland (FI)", "France (FR)", "United Kingdom (GB)", "Georgia (GE)", "Ghana (GH)", "Greece (GR)", "Guatemala (GT)", "Hong Kong (HK)", "Honduras (HN)", "Croatia (HR)", "Haiti (HT)", "Hungary (HU)", "Indonesia (ID)", "Ireland (IE)", "Israel (IL)", "India (IN)", "Iraq (IQ)", "Iran (IR)", "Italy (IT)", "Jamaica (JM)", "Jordan (JO)", "Japan (JP)", "Kenya (KE)", "Kyrgyzstan (KG)", "Cambodia (KH)", "South Korea (KR)", "Kuwait (KW)", "Kazakhstan (KZ)", "Lebanon (LB)", "Sri Lanka (LK)", "Lithuania (LT)", "Latvia (LV)", "Libya (LY)", "Morocco (MA)", "Moldova (MD)", "North Macedonia (MK)", "Mali (ML)", "Myanmar (Burma) (MM)", "Mexico (MX)", "Malaysia (MY)", "Mozambique (MZ)", "Nigeria (NG)", "Nicaragua (NI)", "Netherlands (NL)", "Norway (NO)", "Nepal (NP)", "New Zealand (NZ)", "Oman (OM)", "Panama (PA)", "Peru (PE)", "Philippines (PH)", "Pakistan (PK)", "Poland (PL)", "Puerto Rico (PR)", "Palestine (PS)", "Portugal (PT)", "Paraguay (PY)", "Qatar (QA)", "Romania (RO)", "Serbia (RS)", "Russia (RU)", "Saudi Arabia (SA)", "Sweden (SE)", "Singapore (SG)", "Slovenia (SI)", "Slovakia (SK)", "Senegal (SN)", "El Salvador (SV)", "Syria (SY)", "Thailand (TH)", "Turkmenistan (TM)", "Tunisia (TN)", "Türkiye (TR)", "Trinidad & Tobago (TT)", "Taiwan (TW)", "Tanzania (TZ)", "Ukraine (UA)", "Uganda (UG)", "United States (US)", "Uruguay (UY)", "Uzbekistan (UZ)", "Venezuela (VE)", "Vietnam (VN)", "Yemen (YE)", "South Africa (ZA)", "Zambia (ZM)", "Zimbabwe (ZW)" ] }, "default": [ "US" ] }, "maxItemsPerGeo": { "title": "Max trends per country", "minimum": 1, "maximum": 25, "type": "integer", "description": "Upper limit of trending searches per country. The feed currently lists up to 10 per country (fewer for small countries).", "default": 10 }, "onlyNewSinceLastRun": { "title": "Only new trends since the last run", "type": "boolean", "description": "For schedules: skip trends this monitor already returned (same country, keyword and start day). Skipped trends are not charged.", "default": false }, "monitorName": { "title": "Monitor name", "maxLength": 48, "type": "string", "description": "Name of the seen-trends memory used by 'Only new trends' (stored in the key-value store trends-seen-). Use one name per schedule.", "default": "default" }, "keywords": { "title": "Keywords", "maxItems": 20, "type": "array", "description": "Search terms to explore (up to 20). Each keyword returns interest over time, interest by region and top + rising related queries. Values are relative (0-100) within each comparison.", "default": [], "items": { "type": "string" } }, "keywordsPerComparison": { "title": "Keywords per comparison", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keywords are compared in groups of this size (Google allows at most 5). Use 1 to explore every keyword on its own scale.", "default": 5 }, "timeframe": { "title": "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": "Time range for interest over time, regions and related queries.", "default": "today 12-m" }, "customTimeframe": { "title": "Custom date range", "pattern": "^(\\d{4}-\\d{2}-\\d{2} \\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Optional \"YYYY-MM-DD YYYY-MM-DD\" range; overrides Timeframe.", "default": "" }, "exploreGeo": { "title": "Location for keywords", "pattern": "^([A-Za-z]{2}(-[A-Za-z0-9]{1,3}){0,2})?$", "type": "string", "description": "Country (US), region (US-CA) or empty for worldwide. Regions in the output are the next level down (countries, states, ...).", "default": "" }, "category": { "title": "Category ID", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Google Trends category id (0 = all categories; e.g. 71 = Food & Drink, 7 = Finance).", "default": 0 }, "property": { "title": "Search type", "enum": [ "web", "news", "youtube", "images", "froogle" ], "type": "string", "description": "Which Google search property to measure.", "default": "web" } } }, "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 } } } } } } } } } }