{ "openapi": "3.0.1", "info": { "title": "Google News Scraper: Keywords, Topics, RSS", "description": "[$2.50 / 1K] Google News by keyword, topic or publisher in any language edition, plus any RSS or Atom feed. Decodes the Google redirect to the publisher URL. A date range is split into day-sized windows to beat the 100-item ceiling: one keyword over a week returned 632 articles.", "version": "0.1", "x-build-id": "AMsQxVJiGrA4HHbJn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deriverge~google-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deriverge-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/deriverge~google-news-scraper/runs": { "post": { "operationId": "runs-sync-deriverge-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/deriverge~google-news-scraper/run-sync": { "post": { "operationId": "run-sync-deriverge-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 in Google News. Google's operators work: \"exact phrase\", site:reuters.com to limit to a publisher, -word to exclude, when:7d for the last week.", "items": { "type": "string" } }, "topics": { "title": "Topics", "type": "array", "description": "Google News topic sections for the chosen language and country.", "items": { "type": "string", "enum": [ "WORLD", "NATION", "BUSINESS", "TECHNOLOGY", "ENTERTAINMENT", "SPORTS", "SCIENCE", "HEALTH" ], "enumTitles": [ "World", "Nation", "Business", "Technology", "Entertainment", "Sports", "Science", "Health" ] } }, "topStories": { "title": "Top stories", "type": "boolean", "description": "Include the front page of the chosen edition.", "default": false }, "feeds": { "title": "Extra RSS or Atom feeds", "type": "array", "description": "Any feed URLs to read alongside Google News, for example a publisher's own RSS. Same output format, same deduplication.", "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code of the Google News edition (en, de, fr, cs, es, pt, ja...).", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code of the Google News edition (US, GB, DE, CZ, BR, IN...).", "default": "US" }, "maxItemsPerSource": { "title": "Maximum articles per query, topic or feed", "minimum": 1, "maximum": 100, "type": "integer", "description": "Google News returns up to 100 items per query.", "default": 100 }, "resolveLinks": { "title": "Resolve Google redirect links to the real article URL", "type": "boolean", "description": "Google News links point to news.google.com. When on, the actor decodes or follows each link to the publisher's own URL. Turn off for faster runs if you only need titles and sources.", "default": true }, "publishedWithinHours": { "title": "Published within the last N hours", "minimum": 1, "type": "integer", "description": "Drop articles older than this. Leave empty for no limit." }, "newOnly": { "title": "Return only articles that appeared since the last run", "type": "boolean", "description": "Keeps a snapshot per watch name (or per saved task) and returns only articles not seen in the previous run. Schedule it hourly or daily and you get a clean news feed for a brand, a competitor or a topic.", "default": false }, "watchKey": { "title": "Watch name", "type": "string", "description": "Name of the snapshot used by new-only mode, for example \"brand-mentions\". Runs from a saved task get a snapshot automatically." }, "dateFrom": { "title": "From date (YYYY-MM-DD)", "type": "string", "description": "Start of the period to cover. Google News returns at most 100 items per query, so when a date range is set every query is split into day-sized windows and the results are merged and deduplicated. A week of one busy keyword returns about 640 articles instead of 100." }, "dateTo": { "title": "To date (YYYY-MM-DD)", "type": "string", "description": "End of the period, inclusive. Ranges longer than 92 days are cut to 92 days." } } }, "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 } } } } } } } } } }