{ "openapi": "3.0.1", "info": { "title": "Google News Scraper", "description": "Monitor the news automatically with our Google News scraper. Track articles by keyword or topic with flexible date filtering and multi language support. Access structured data including headlines, publishers, links, and more. Built for teams that need reliable news insights without manual work.", "version": "1.0", "x-build-id": "oyedJijaq65qIKdUA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~google-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-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/parseforge~google-news-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-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/parseforge~google-news-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-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", "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Keyword or phrase to search Google News. Supports advanced operators like \"site:bbc.com\", \"intitle:AI\", exact match with quotes. Cannot be used together with Topics." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 100. Paid users: Optional, max 1,000,000. When requesting more than 100 with a search query, results are fetched day by day automatically." }, "language": { "title": "Language and Region", "enum": [ "en:US", "en:GB", "en:AU", "en:CA", "en:IN", "en:IE", "en:NZ", "en:SG", "en:ZA", "en:PH", "en:MY", "en:NG", "en:GH", "en:KE", "en:PK", "es:ES", "es:MX", "es:AR", "es:CL", "es:CO", "es:PE", "es:VE", "es:CU", "es:US", "fr:FR", "fr:CA", "fr:BE", "fr:CH", "fr:SN", "fr:MA", "de:DE", "de:AT", "de:CH", "pt:BR", "pt:PT", "it:IT", "nl:NL", "nl:BE", "ja:JP", "ko:KR", "zh-Hans:CN", "zh-Hant:TW", "zh-Hant:HK", "ru:RU", "ru:UA", "ar:SA", "ar:EG", "ar:AE", "ar:LB", "hi:IN", "ta:IN", "te:IN", "ml:IN", "bn:IN", "mr:IN", "kn:IN", "gu:IN", "th:TH", "vi:VN", "id:ID", "ms:MY", "tl:PH", "tr:TR", "pl:PL", "uk:UA", "ro:RO", "el:GR", "hu:HU", "cs:CZ", "sv:SE", "no:NO", "da:DK", "fi:FI", "sk:SK", "bg:BG", "sr:RS", "hr:HR", "lt:LT", "lv:LV", "et:EE", "sl:SI", "he:IL" ], "type": "string", "description": "Select the language and region for Google News results.", "default": "en:US" }, "dateFrom": { "title": "Date From", "type": "string", "description": "Start date for filtering articles (YYYY-MM-DD). Only applies to search query mode." }, "dateTo": { "title": "Date To", "type": "string", "description": "End date for filtering articles (YYYY-MM-DD). Only applies to search query mode." }, "openEndedDateRange": { "title": "Open-Ended Date Range", "type": "string", "description": "Relative date range for recent articles. Cannot be used together with Date From/To. Examples: 1h (last hour), 24h (last 24 hours), 7d (last 7 days), 1y (last year)." }, "topics": { "title": "Standard Topics", "type": "array", "description": "Select one or more Google News topic sections. Each topic is fetched separately and results are combined. Can be used together with Search Query.", "items": { "type": "string", "enum": [ "WORLD", "NATION", "BUSINESS", "TECHNOLOGY", "ENTERTAINMENT", "SPORTS", "SCIENCE", "HEALTH" ] } }, "topicsHashed": { "title": "Hashed Topic IDs", "type": "array", "description": "Custom Google News topic IDs. Find these in Google News URLs when browsing a specific topic. Supports topic sections by using the format: TOPIC_ID/sections/SECTION_ID", "items": { "type": "string" } }, "fetchArticleDetails": { "title": "Fetch Article Details", "type": "boolean", "description": "When enabled, each article URL is decoded to the real destination and additional data is collected: preview image, description, author, category, modification date, and keywords. Slower but provides much richer data.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optional proxy settings. Useful when fetchArticleDetails is enabled and target sites are geo-restricted." } } }, "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 } } }, "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 } } } } } } } } } }