{
"openapi": "3.0.1",
"info": {
"title": "Google News Scraper – Full Article Text & Real Publisher URLs",
"description": "Google News scraper for headlines, keyword search, topics and local news in any language and country. Get the real publisher article URL (decoded from news.google.com links), source, publish date and optional full article text, author and image. No login, no API key.",
"version": "1.0",
"x-build-id": "ah1Q0fs1XvFSkkDnJ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/openharvest~google-news-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-openharvest-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/openharvest~google-news-scraper/runs": {
"post": {
"operationId": "runs-sync-openharvest-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/openharvest~google-news-scraper/run-sync": {
"post": {
"operationId": "run-sync-openharvest-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, one per line. Google search operators work: \"exact phrase\", OR, -exclude, site:reuters.com, intitle:. Leave empty (and leave Topics empty) to get today's top stories.",
"items": {
"type": "string"
}
},
"topics": {
"title": "Topics",
"type": "array",
"description": "Google News topic sections to scrape (headlines for the chosen language/country).",
"items": {
"type": "string",
"enum": [
"TOP_STORIES",
"WORLD",
"NATION",
"BUSINESS",
"TECHNOLOGY",
"ENTERTAINMENT",
"SPORTS",
"SCIENCE",
"HEALTH"
],
"enumTitles": [
"Top stories",
"World",
"Nation (your country)",
"Business",
"Technology",
"Entertainment",
"Sports",
"Science",
"Health"
]
}
},
"locations": {
"title": "Local news (locations)",
"type": "array",
"description": "Optional. City, region or country names for Google News local headlines, e.g. London, California, Berlin.",
"items": {
"type": "string"
}
},
"language": {
"title": "Language",
"pattern": "^[a-zA-Z]{2,3}$",
"type": "string",
"description": "2-letter language code of the Google News edition, e.g. en, de, fr, es, tr, ja.",
"default": "en"
},
"country": {
"title": "Country",
"pattern": "^[a-zA-Z]{2}$",
"type": "string",
"description": "2-letter country code of the Google News edition, e.g. US, GB, IN, DE, TR, BR.",
"default": "US"
},
"timeRange": {
"title": "Time range",
"enum": [
"any",
"1h",
"1d",
"7d",
"30d",
"1y"
],
"type": "string",
"description": "Only articles published within this period. For search queries Google filters on its side (when: operator); for topics and locations the Actor filters by publish date.",
"default": "any"
},
"maxItems": {
"title": "Max articles per query / topic",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Maximum number of articles for each query, topic or location. One Google News feed holds up to 100 articles; for search queries above 100 the Actor automatically searches day by day to go deeper (up to 5,000). You pay per article, so this also caps your cost.",
"default": 20
},
"decodeUrls": {
"title": "Decode real article URLs",
"type": "boolean",
"description": "Convert Google's news.google.com/rss/articles/... redirect links into the real publisher URL (articleUrl). Turn off only if you just need titles and Google links (slightly faster).",
"default": true
},
"fullText": {
"title": "Extract full article text",
"type": "boolean",
"description": "Open every article on the publisher's site and extract the main text (Mozilla Readability), plus description, author and image. Charged as article-full-text only when text was extracted; paywalled or blocked articles are marked in fullTextStatus and charged as a normal article.",
"default": false
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Usually not needed. Enable Apify Proxy only if you run very large jobs and see many 429 (rate-limit) warnings or decodeStatus = failed.",
"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
}
}
}
}
}
}
}
}
}
}