{ "openapi": "3.0.1", "info": { "title": "Google News Scraper", "description": "Search Google News by keyword, topic or location in 50+ country editions. Get headline, publisher, publish time and the real article URL, plus related coverage. Optionally extract image, author and full article text. Daily split goes past the 100 result limit.", "version": "1.0", "x-build-id": "0YkruqkZnNFbmwKwy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datamole~google-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datamole-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/datamole~google-news-scraper/runs": { "post": { "operationId": "runs-sync-datamole-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/datamole~google-news-scraper/run-sync": { "post": { "operationId": "run-sync-datamole-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": { "queries": { "title": "Search queries", "type": "array", "description": "Keywords to search on Google News. Supports Google operators like \"exact phrase\", OR, -exclude and intitle:.", "items": { "type": "string" } }, "maxItemsPerFeed": { "title": "Max articles per feed", "minimum": 1, "maximum": 100, "type": "integer", "description": "Google News returns up to 100 articles per query, topic or day. Use a date range with daily split to go past this limit.", "default": 100 }, "maxItems": { "title": "Max articles in total", "minimum": 1, "type": "integer", "description": "Hard cap for the whole run. Leave empty for no cap." }, "topics": { "title": "Topics", "type": "array", "description": "Google News topic sections.", "items": { "type": "string", "enum": [ "WORLD", "NATION", "BUSINESS", "TECHNOLOGY", "ENTERTAINMENT", "SPORTS", "SCIENCE", "HEALTH" ], "enumTitles": [ "World", "Nation", "Business", "Technology", "Entertainment", "Sports", "Science", "Health" ] } }, "locations": { "title": "Local news (cities, regions, countries)", "type": "array", "description": "Local headlines for places like \"New York\", \"Bogota\" or \"Madrid\".", "items": { "type": "string" } }, "includeTopStories": { "title": "Include top stories", "type": "boolean", "description": "Add the main Google News front page for each edition.", "default": false }, "editions": { "title": "Editions (country and language)", "type": "array", "description": "Pick one or more Google News editions.", "items": { "type": "string", "enum": [ "US:en", "US:es-419", "GB:en", "CA:en", "CA:fr", "AU:en", "NZ:en", "IE:en", "IN:en", "IN:hi", "SG:en", "PH:en", "ZA:en", "NG:en", "KE:en", "MX:es-419", "CO:es-419", "AR:es-419", "CL:es-419", "PE:es-419", "VE:es-419", "ES:es", "BR:pt-419", "PT:pt-150", "FR:fr", "BE:fr", "BE:nl", "CH:de", "DE:de", "AT:de", "IT:it", "NL:nl", "SE:sv", "NO:no", "PL:pl", "CZ:cs", "HU:hu", "RO:ro", "GR:el", "TR:tr", "UA:uk", "RU:ru", "IL:he", "AE:ar", "SA:ar", "EG:ar", "JP:ja", "KR:ko", "TW:zh-Hant", "HK:zh-Hant", "ID:id", "MY:en", "TH:th", "VN:vi" ], "enumTitles": [ "United States (English)", "United States (Spanish)", "United Kingdom", "Canada (English)", "Canada (French)", "Australia", "New Zealand", "Ireland", "India (English)", "India (Hindi)", "Singapore", "Philippines", "South Africa", "Nigeria", "Kenya", "Mexico", "Colombia", "Argentina", "Chile", "Peru", "Venezuela", "Spain", "Brazil", "Portugal", "France", "Belgium (French)", "Belgium (Dutch)", "Switzerland (German)", "Germany", "Austria", "Italy", "Netherlands", "Sweden", "Norway", "Poland", "Czechia", "Hungary", "Romania", "Greece", "Turkey", "Ukraine", "Russia", "Israel", "United Arab Emirates", "Saudi Arabia", "Egypt", "Japan", "South Korea", "Taiwan", "Hong Kong", "Indonesia", "Malaysia", "Thailand", "Vietnam" ] }, "default": [ "US:en" ] }, "timeRange": { "title": "Time range", "enum": [ "any", "1h", "1d", "7d", "30d", "1y" ], "type": "string", "description": "Quick date filter for search queries. Ignored when a date range is set.", "default": "any" }, "dateFrom": { "title": "From date", "type": "string", "description": "Start of a custom date range for search queries (YYYY-MM-DD)." }, "dateTo": { "title": "To date", "type": "string", "description": "End of the custom date range (YYYY-MM-DD). Defaults to today." }, "splitByDay": { "title": "Split date range by day", "type": "boolean", "description": "Search each day separately to get up to 100 articles per day instead of 100 in total. Best for historical research.", "default": true }, "includeSites": { "title": "Only these sites", "type": "array", "description": "Limit results to these publishers, e.g. reuters.com, bloomberg.com.", "items": { "type": "string" } }, "excludeSites": { "title": "Exclude sites", "type": "array", "description": "Remove these publishers from the results.", "items": { "type": "string" } }, "decodeUrls": { "title": "Resolve real article URLs", "type": "boolean", "description": "Google News links are encoded redirects. This converts them into the real publisher URL.", "default": true }, "includeRelated": { "title": "Include related coverage", "type": "boolean", "description": "For grouped stories, list the other outlets covering the same story.", "default": true }, "extractArticle": { "title": "Extract article content", "type": "boolean", "description": "Visit each publisher page and add image, description, author, publish time, language and full text. Slower. Some publishers block this or use paywalls.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed in most cases. Useful for very large runs or article extraction." } } }, "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 } } } } } } } } } }