{ "openapi": "3.0.1", "info": { "title": "Google News Scraper & Monitor", "description": "Gets Google News articles for your keywords with the original article URLs. Schedule it to monitor brands and competitors: each run returns only articles that are new since the last run, plus a spike signal per keyword.", "version": "0.1", "x-build-id": "CjgC4kN2pNqFdbits" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lyklo~google-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lyklo-google-news-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/lyklo~google-news-scraper/runs": { "post": { "operationId": "runs-sync-lyklo-google-news-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/lyklo~google-news-scraper/run-sync": { "post": { "operationId": "run-sync-lyklo-google-news-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", "required": [ "queries" ], "properties": { "queries": { "title": "Search terms", "type": "array", "description": "One search per line. Google News search syntax works: \"exact phrase\", OR, -exclude, site:reuters.com, intitle:word.", "items": { "type": "string" } }, "mode": { "title": "What to return", "enum": [ "all", "changes" ], "type": "string", "description": "All articles: every article in the time range, every run. New since the last run: only articles not returned before by a run with the same watch name (the first run returns the time range).", "default": "all" }, "timeframe": { "title": "Time range", "enum": [ "1h", "1d", "7d", "30d", "1y" ], "type": "string", "description": "How far back to look. In New since the last run mode this applies to the first run; later runs read from 2 days before the previous run.", "default": "7d" }, "dateFrom": { "title": "From date", "type": "string", "description": "Optional. A fixed start date instead of the time range. The run reads day by day, so a long range can return more than 100 articles." }, "dateTo": { "title": "To date", "type": "string", "description": "Optional. The last day to read (today if empty)." }, "edition": { "title": "Edition", "enum": [ "US:en", "GB:en", "CA:en", "AU:en", "IN:en", "IE:en", "NZ:en", "SG:en", "ZA:en", "PH:en", "JP:ja", "KR:ko", "TW:zh-Hant", "HK:zh-Hant", "DE:de", "FR:fr", "CA:fr", "ES:es", "MX:es-419", "AR:es-419", "BR:pt-419", "PT:pt-150", "IT:it", "NL:nl", "PL:pl", "SE:sv", "NO:no", "TR:tr", "IL:he", "ID:id", "TH:th", "VN:vi", "UA:uk", "AE:ar", "SA:ar" ], "type": "string", "description": "The Google News edition: country and language.", "default": "US:en" }, "maxArticlesPerQuery": { "title": "Maximum articles per search", "minimum": 1, "maximum": 2000, "type": "integer", "description": "The most articles to return for each search term in one run. In New since the last run mode, new articles beyond this number are skipped (and counted in newOverMax).", "default": 100 }, "resolveUrls": { "title": "Find original article URLs", "type": "boolean", "description": "Turns each Google News link into the publisher's own article URL. Turn off for faster runs if the Google News link is enough.", "default": true }, "watchName": { "title": "Watch name", "type": "string", "description": "New since the last run mode only. Keeps the memory of past runs separate for each watch, for example one per client. Letters, numbers and dashes.", "default": "default" } } }, "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 } } } } } } } } } }