{ "openapi": "3.0.1", "info": { "title": "Google Trending Now — Free Daily Trending Searches by Country", "description": "Free: get Google Trending Now searches for 125 countries, with rank, approximate search volume, start time, image and related news headlines. Export to JSON, CSV or Google Sheets. Not affiliated with Google.", "version": "0.2", "x-build-id": "XSYtmfFWHYaaPHwat" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datarock~google-trending-now/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datarock-google-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/datarock~google-trending-now/runs": { "post": { "operationId": "runs-sync-datarock-google-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/datarock~google-trending-now/run-sync": { "post": { "operationId": "run-sync-datarock-google-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 / regions", "type": "array", "description": "ISO 2-letter country codes (125 verified, e.g. US, GB, DE, IN, BR, JP), sub-national regions like US-CA or DE-BY, or US metro codes like 501. Many per run. A code Google does not support returns one item with status 'unsupported_country'; other countries still run.", "default": [ "US" ], "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "volume", "recency", "title" ], "type": "string", "description": "Order within each country. 'rank' follows this order; 'googleRank' keeps Google's original position.", "default": "relevance" }, "maxItemsPerCountry": { "title": "Max trends per country", "minimum": 0, "type": "integer", "description": "0 = all trends in Google's Trending Now feed for the country (up to 10). Set lower to keep only the top N.", "default": 0 }, "includeNews": { "title": "Include news articles", "type": "boolean", "description": "Add related news headlines (title, URL, source, published time, image) to each trend.", "default": true }, "newsPerTrend": { "title": "News articles per trend", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many news articles to attach to each trend (1–10).", "default": 3 }, "outputFormat": { "title": "Output format", "enum": [ "nested", "flat" ], "type": "string", "description": "'flat' joins related terms and news into text columns, so CSV/Excel/Sheets exports have one clean row per trend.", "default": "nested" }, "onlyNewSinceLastRun": { "title": "Only new since last run", "type": "boolean", "description": "For scheduled runs: skip trends already returned by a previous run with the same countries (state kept in a named key-value store in your account).", "default": false }, "stateKey": { "title": "State key (optional)", "type": "string", "description": "Custom name for the 'only new' state, if you run several schedules with the same settings." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional; not needed for normal use. Enable only if you see status 'rateLimited'.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }