{ "openapi": "3.0.1", "info": { "title": "Google News Scraper: Headlines, Sources, Real Article URLs", "description": "Scrape Google News by keyword, topic, location or top stories in any country and language. Get title, source, publish date, rank and the real publisher URL decoded from every Google News link. Date windows, search operators and day-by-day splitting past the 100-result feed limit.", "version": "1.0", "x-build-id": "te93PWJem0OR05P8M" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fernandosord~google-news-rss-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fernandosord-google-news-rss-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/fernandosord~google-news-rss-scraper/runs": { "post": { "operationId": "runs-sync-fernandosord-google-news-rss-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/fernandosord~google-news-rss-scraper/run-sync": { "post": { "operationId": "run-sync-fernandosord-google-news-rss-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Words or phrases to search Google News for. Google's search operators work: \"exact phrase\", OR, -exclude, site:reuters.com, intitle:earnings, when:7d.", "items": { "type": "string" } }, "topics": { "title": "Topics", "type": "array", "description": "Google News topic sections for the chosen country.", "items": { "type": "string", "enum": [ "WORLD", "NATION", "BUSINESS", "TECHNOLOGY", "ENTERTAINMENT", "SPORTS", "SCIENCE", "HEALTH" ], "enumTitles": [ "World", "Nation (the chosen country)", "Business", "Technology", "Entertainment", "Sports", "Science", "Health" ] } }, "locations": { "title": "Local news", "type": "array", "description": "City, region or country names for Google News local sections, for example Toronto or Texas.", "items": { "type": "string" } }, "includeTopStories": { "title": "Top stories", "type": "boolean", "description": "Also scrape the Google News front page (top stories) for the chosen country. Each story includes its related coverage from other outlets.", "default": false }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code of the Google News edition, for example US, GB, CA, IN, DE, BR, JP.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Language code of the edition, for example en, fr, de, es-419, pt-419, ja, zh-Hant. It must be a language Google News offers in that country (CA with fr works, US with de does not).", "default": "en" }, "timeRange": { "title": "Time range", "enum": [ "", "1h", "12h", "1d", "7d", "30d", "1y" ], "type": "string", "description": "Only news from this recent period. Applies to search queries (Google's when: operator). Ignored if you set a date window.", "default": "" }, "dateFrom": { "title": "Published from", "type": "string", "description": "Optional. A date (2026-10-01) or a relative period (7 days, 3 months). Searches ask Google for this window, and every feed is also filtered by publish date." }, "dateTo": { "title": "Published to", "type": "string", "description": "Optional. Last day to include, as a date or relative period. Leave empty for up to today." }, "splitByDay": { "title": "Split the date window by day", "type": "boolean", "description": "Each Google News feed stops at about 100 articles. Turn this on to run a search once per day of the date window, newest day first, to collect more than 100. Needs Published from. Raise Max articles per query too.", "default": false }, "maxArticlesPerQuery": { "title": "Max articles per query", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Limit for each search query, topic or location. A single feed holds up to about 100 articles.", "default": 100 }, "decodeUrls": { "title": "Decode real article URLs", "type": "boolean", "description": "Google News links are redirects. With this on, each one is turned into the publisher's own article URL. Turn it off for faster runs that only need headlines.", "default": true }, "decodeConcurrency": { "title": "Decoding concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many links to decode at the same time. Higher is faster but more likely to be slowed down by Google.", "default": 5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Off by default. Google News feeds and link decoding work without a proxy, and decoding is much faster without one. If Google refuses direct requests during a run on Apify, the run switches to Apify Proxy by itself. Turn a proxy on here to use it from the start.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }