{ "openapi": "3.0.1", "info": { "title": "Google Trends Trending Now Scraper & API: 125 Countries", "description": "Google Trends Trending Now scraper: the searches trending on Google right now in 125 countries and US states, with approximate search volume, start time and news stories, from Google's official public RSS feed. Monitor mode returns only new trends. $1 per 1,000 trends.", "version": "0.1", "x-build-id": "Nrd0eIMv9s0g77RSl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/localwire~google-trends-trending-now/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-localwire-google-trends-trending-now", "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/localwire~google-trends-trending-now/runs": { "post": { "operationId": "runs-sync-localwire-google-trends-trending-now", "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/localwire~google-trends-trending-now/run-sync": { "post": { "operationId": "run-sync-localwire-google-trends-trending-now", "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": { "countries": { "title": "Countries", "type": "array", "description": "Countries to get trending searches for, as two-letter ISO codes (GB, US, DE, JP…). Google publishes the Trending now feed for 125 countries, and each returns about 10 trends. If neither countries nor regions are given, GB and US are fetched.", "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 SAR China (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)", "Palestinian Territories (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)" ] } }, "subdivisions": { "title": "Regions (optional)", "type": "array", "description": "Regions within a supported country, as ISO 3166-2 codes, e.g. US-CA (California), US-NY, GB-SCT. Fetched in addition to any countries listed; given on their own, only the regions are fetched. A region Google has no feed for is reported and skipped.", "items": { "type": "string" } }, "allCountries": { "title": "All supported countries", "type": "boolean", "description": "Fetch every supported country (125), ignoring the list above. Takes a few minutes because the Actor waits politely between requests.", "default": false }, "includeNews": { "title": "Include news stories", "type": "boolean", "description": "Add up to 3 news stories (headline, publisher, link, image) that Google links to each trend.", "default": true }, "minTraffic": { "title": "Minimum searches", "minimum": 0, "type": "integer", "description": "Only return trends with at least this approximate search volume (Google publishes rounded values such as 200+, 2000+, 20000+)." }, "includeKeywords": { "title": "Include keywords", "type": "array", "description": "Only return trends that contain ANY of these words or phrases (case- and accent-insensitive).", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop trends that contain any of these words or phrases.", "items": { "type": "string" } }, "matchNewsHeadlines": { "title": "Match keywords in news headlines too", "type": "boolean", "description": "Apply the keyword filters to the trend's news headlines as well as the search itself, so \"football\" also finds a trending player's name.", "default": true }, "monitorMode": { "title": "Monitor mode: only new trends", "type": "boolean", "description": "Remember what earlier runs returned and return only trends that are new. Use it with a schedule every 15-30 minutes to catch every trend without paying twice.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Tasks with different countries or filters should use different names so each keeps its own memory.", "default": "default" }, "forgetAfterHours": { "title": "Count a trend as new again after", "minimum": 1, "maximum": 720, "type": "integer", "description": "A trend that drops out of the feed and comes back after this many hours is returned again.", "default": 24 }, "historyDatasetName": { "title": "History dataset name", "type": "string", "description": "Also add every returned trend to this named dataset, which keeps growing across runs (letters, digits and hyphens)." }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many trends (1,000 if left out). Each trend returned costs $0.001; a country returns about 10.", "default": 1000 } } }, "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 } } } } } } } } } }