{ "openapi": "3.0.1", "info": { "title": "Google News Scraper: Search, Topics & Article URLs", "description": "Scrape Google News search results, topic headlines and top stories in 47 country and language editions. Titles, publishers, dates, related coverage and resolved publisher URLs (not Google redirects). Fast, no login, no proxy.", "version": "0.1", "x-build-id": "MBHn1iIcaPIi0nyGQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/veenkes~veenkes-google-news/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-veenkes-veenkes-google-news", "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/veenkes~veenkes-google-news/runs": { "post": { "operationId": "runs-sync-veenkes-veenkes-google-news", "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/veenkes~veenkes-google-news/run-sync": { "post": { "operationId": "run-sync-veenkes-veenkes-google-news", "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": { "queries": { "title": "Search queries", "type": "array", "description": "Google News searches. Google operators work: \"exact phrase\", OR, -exclude, site:reuters.com, intitle:. Each query returns up to 100 newest/most relevant articles.", "items": { "type": "string" } }, "topics": { "title": "Topics", "type": "array", "description": "Google News topic sections (headlines). Leave empty if you only want search results. If both lists are empty, Top stories are scraped.", "items": { "type": "string", "enum": [ "TOP_STORIES", "WORLD", "NATION", "BUSINESS", "TECHNOLOGY", "ENTERTAINMENT", "SPORTS", "SCIENCE", "HEALTH" ], "enumTitles": [ "Top stories", "World", "Nation (country)", "Business", "Technology", "Entertainment", "Sports", "Science", "Health" ] } }, "region": { "title": "Country / language edition", "enum": [ "US:en", "GB:en", "CA:en", "AU:en", "IN:en", "IE:en", "NZ:en", "SG:en", "ZA:en", "NG:en", "DE:de", "AT:de", "CH:de", "FR:fr", "BE:fr", "ES:es", "MX:es", "AR:es", "CO:es", "IT:it", "NL:nl", "PT:pt-PT", "BR:pt-419", "PL:pl", "CZ:cs", "SE:sv", "NO:no", "UA:uk", "RU:ru", "TR:tr", "IL:he", "AE:ar", "SA:ar", "EG:ar", "JP:ja", "KR:ko", "CN:zh-Hans", "TW:zh-Hant", "HK:zh-Hant", "ID:id", "VN:vi", "TH:th", "PH:en", "MY:en", "PK:en", "KZ:ru", "UZ:ru" ], "type": "string", "description": "Which Google News country/language edition to use, for example US:en, GB:en, DE:de or JP:ja (47 editions available).", "default": "US:en" }, "timeRange": { "title": "Time range (search queries)", "enum": [ "any", "1h", "12h", "1d", "7d", "30d", "1y" ], "type": "string", "description": "Only articles from this recent window (hour, day, week, and so on). Applies to search queries, not topic pages.", "default": "any" }, "dateFrom": { "title": "Published after", "type": "string", "description": "Search queries only: articles published after this date (YYYY-MM-DD). Combine with 'Published before' to scrape history day by day." }, "dateTo": { "title": "Published before", "type": "string", "description": "Search queries only: articles published before this date (YYYY-MM-DD)." }, "maxItemsPerQuery": { "title": "Max articles per query/topic", "minimum": 1, "maximum": 100, "type": "integer", "description": "Google News returns up to 100 articles per feed. Split long periods into several date ranges to get more.", "default": 100 }, "resolveUrls": { "title": "Resolve publisher URLs", "type": "boolean", "description": "Turn Google News redirect links into the real article URL (e.g. reuters.com/...). Included in the price.", "default": true }, "dedupe": { "title": "Remove duplicates across queries", "type": "boolean", "description": "Save each article once even if several queries/topics return it.", "default": true } } }, "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 } } } } } } } } } }