{
"openapi": "3.0.1",
"info": {
"title": "Google News Scraper: Search, Topics, Date Ranges & Real URLs",
"description": "Scrape Google News by keyword or topic in any language and country: headline, publisher, publish time, real article URL (decoded from Google links) and related coverage. Date ranges are split by day to get far more than 100 results. Fast, no browser. Pay per article.",
"version": "1.0",
"x-build-id": "VGXcA8JxhaK56rWFG"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/murch1k~google-news-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-murch1k-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/murch1k~google-news-scraper/runs": {
"post": {
"operationId": "runs-sync-murch1k-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/murch1k~google-news-scraper/run-sync": {
"post": {
"operationId": "run-sync-murch1k-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 as you would type them into Google News. Supports Google operators: \"exact phrase\", OR, -exclude, site:reuters.com, intitle:.",
"items": {
"type": "string"
}
},
"topics": {
"title": "Topics (headlines)",
"type": "array",
"description": "Current headlines for a section: TOP, WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH.",
"items": {
"type": "string"
}
},
"language": {
"title": "Language",
"type": "string",
"description": "Google News interface language, e.g. en-US, en-GB, de, fr, es-419, uk, ja.",
"default": "en-US"
},
"country": {
"title": "Country",
"type": "string",
"description": "Two-letter country code of the edition: US, GB, DE, IN, UA…",
"default": "US"
},
"timeRange": {
"title": "Time range",
"enum": [
"any",
"hour",
"day",
"week",
"month",
"year"
],
"type": "string",
"description": "Only for queries, ignored when a date range is set.",
"default": "any"
},
"dateFrom": {
"title": "Date from",
"type": "string",
"description": "Start of a date range (YYYY-MM-DD). The range is searched day by day, so you get up to 100 articles per day instead of 100 in total."
},
"dateTo": {
"title": "Date to",
"type": "string",
"description": "End of the date range (YYYY-MM-DD), inclusive. Defaults to today."
},
"maxArticlesPerQuery": {
"title": "Max articles per query / topic",
"minimum": 1,
"type": "integer",
"description": "Google News returns up to 100 per feed; with a date range up to 100 per day.",
"default": 100
},
"decodeUrls": {
"title": "Resolve real article URLs",
"type": "boolean",
"description": "Google News links are redirects (news.google.com/rss/articles/…). When on, every article also gets its real publisher URL in articleUrl.",
"default": true
},
"includeRelated": {
"title": "Include related coverage",
"type": "boolean",
"description": "Top-story items list other outlets covering the same story.",
"default": true
},
"maxResults": {
"title": "Max results (cost cap)",
"minimum": 0,
"type": "integer",
"description": "Stop after this many articles in total. 0 = no limit.",
"default": 0
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Parallel requests.",
"default": 50
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Requests go direct first (fastest); if Google rate-limits (HTTP 429), retries switch to these proxies with a fresh IP each time. Keep the default Apify datacenter proxy.",
"default": {
"useApifyProxy": 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
}
}
}
}
}
}
}
}
}
}