{
"openapi": "3.0.1",
"info": {
"title": "Google News Scraper - Headlines & Real Article URLs",
"description": "Scrape Google News by keyword, topic or URL: headline, source, publish time and the real article URL (not the Google redirect). Any country and language, date ranges and thousands of articles via day-by-day search.",
"version": "0.1",
"x-build-id": "ubcXKdc3uQkgEPUe6"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/dataspace~google-news-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-dataspace-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/dataspace~google-news-scraper/runs": {
"post": {
"operationId": "runs-sync-dataspace-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/dataspace~google-news-scraper/run-sync": {
"post": {
"operationId": "run-sync-dataspace-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": {
"searchTerms": {
"title": "Search terms",
"type": "array",
"description": "One search per line. Google News search operators work: \"exact phrase\", OR, -exclude, site:reuters.com, intitle:nvidia.",
"items": {
"type": "string"
}
},
"topics": {
"title": "Topics",
"type": "array",
"description": "Headlines of Google News sections for the selected edition.",
"items": {
"type": "string",
"enum": [
"TOP_STORIES",
"WORLD",
"NATION",
"BUSINESS",
"TECHNOLOGY",
"ENTERTAINMENT",
"SPORTS",
"SCIENCE",
"HEALTH"
],
"enumTitles": [
"Top stories",
"World",
"Your country",
"Business",
"Technology",
"Entertainment",
"Sports",
"Science",
"Health"
]
}
},
"googleNewsUrls": {
"title": "Google News URLs",
"type": "array",
"description": "Optional. Paste any Google News topic, section or publication page URL (e.g. a 'Technology > Artificial intelligence' page).",
"items": {
"type": "string"
}
},
"timeRange": {
"title": "Time range",
"enum": [
"any",
"1h",
"1d",
"7d",
"30d",
"1y"
],
"type": "string",
"description": "Only articles published in this period (for search terms).",
"default": "any"
},
"dateFrom": {
"title": "From date",
"type": "string",
"description": "Optional exact date range for search terms (overrides Time range)."
},
"dateTo": {
"title": "To date",
"type": "string",
"description": "End of the date range (inclusive)."
},
"maxArticlesPerQuery": {
"title": "Max articles per search / topic",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Google News returns up to 100 articles per request. For more, set a time range or dates — the Actor then searches day by day (up to 100 articles per day).",
"default": 100
},
"edition": {
"title": "Country and language",
"enum": [
"US:en",
"GB:en",
"IN:en",
"CA:en",
"AU:en",
"IE:en",
"NZ:en",
"SG:en",
"ZA:en",
"NG:en",
"PH:en",
"DE:de",
"AT:de",
"CH:de",
"FR:fr",
"ES:es",
"MX:es-419",
"AR:es-419",
"IT:it",
"BR:pt-419",
"PT:pt-150",
"NL:nl",
"BE:nl",
"PL:pl",
"SE:sv",
"NO:no",
"TR:tr",
"JP:ja",
"KR:ko",
"TW:zh-Hant",
"HK:zh-Hant",
"ID:id",
"IL:he",
"AE:ar",
"SA:ar",
"EG:ar",
"UA:uk",
"CZ:cs",
"GR:el",
"RO:ro",
"HU:hu",
"TH:th",
"VN:vi"
],
"type": "string",
"description": "Google News edition: decides the language and which local sources are shown.",
"default": "US:en"
},
"resolveArticleUrls": {
"title": "Get the real article URL",
"type": "boolean",
"description": "Turns Google News redirect links into the publisher's real article URL (e.g. https://www.reuters.com/...). Included in the price.",
"default": true
},
"includeArticleDetails": {
"title": "Add article image and description",
"type": "boolean",
"description": "Reads the article's public link preview (the same image and summary that social networks show when the link is shared). The article text is not collected. Needs Resolve article URLs.",
"default": true
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Requests switch to a fresh proxy IP automatically if Google rate-limits them.",
"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
}
}
}
}
}
}
}
}
}
}