{
"openapi": "3.0.1",
"info": {
"title": "Google News Scraper – Full Text & Direct URLs",
"description": "Scrape Google News by keyword, topic or link: every article with its direct publisher URL (not the Google redirect), source and date. Optional full text, image and author. Any country and language, day-by-day date ranges past the 100-article limit, and an only-new mode for monitoring.",
"version": "1.0",
"x-build-id": "1zd373axUmTTuBQJk"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/brii3343~google-news-scraper-full-text/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-brii3343-google-news-scraper-full-text",
"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/brii3343~google-news-scraper-full-text/runs": {
"post": {
"operationId": "runs-sync-brii3343-google-news-scraper-full-text",
"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/brii3343~google-news-scraper-full-text/run-sync": {
"post": {
"operationId": "run-sync-brii3343-google-news-scraper-full-text",
"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": "One search per line, with Google operators if you like: \"electric cars\" (exact phrase), tesla OR rivian, apple -iphone, site:reuters.com oil, intitle:bitcoin.",
"items": {
"type": "string"
}
},
"topics": {
"title": "Topics (optional)",
"type": "array",
"description": "Google News sections: TOP (top stories), WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH.",
"items": {
"type": "string"
}
},
"googleNewsUrls": {
"title": "Google News links (optional)",
"type": "array",
"description": "Links copied from news.google.com: a search, a topic or section page, a publication, full coverage, or the home page. Country and language are taken from the link.",
"items": {
"type": "string"
}
},
"country": {
"title": "Country",
"type": "string",
"description": "Google News edition: two-letter country code (US, GB, IN, DE, IT, BR...).",
"default": "US"
},
"language": {
"title": "Language",
"type": "string",
"description": "Language of the edition: en, de, fr, es, it, pt, ja, hi... The country must have an edition in that language (for example CA + fr).",
"default": "en"
},
"timeRange": {
"title": "Time range",
"enum": [
"any",
"1h",
"1d",
"7d",
"30d",
"1y"
],
"type": "string",
"description": "Only articles published in the last hour, day, week, month or year (search queries only). Ignored when you set a date range.",
"default": "any"
},
"dateFrom": {
"title": "From date (optional)",
"type": "string",
"description": "Search every day from this date to the \"To date\" (one search per day, so you get up to ~100 articles per day instead of 100 in total). YYYY-MM-DD, or a number of days ago (7)."
},
"dateTo": {
"title": "To date (optional)",
"type": "string",
"description": "Last day of the date range (default: today). YYYY-MM-DD, or a number of days ago (0 = today)."
},
"maxArticles": {
"title": "Max articles per search",
"minimum": 0,
"type": "integer",
"description": "Maximum articles for each query, topic or link (for a date range: for each day). Google News gives up to about 100. 0 = all.",
"default": 100
},
"decodeUrls": {
"title": "Direct article links",
"type": "boolean",
"description": "Turn Google News redirect links into the real publisher URLs (recommended). Articles whose link cannot be decoded are included for free.",
"default": true
},
"fetchDetails": {
"title": "Full text, image and author",
"type": "boolean",
"description": "Open each article on the publisher's site and add the full text (clean paragraphs, ready for AI), main image, description, author and word count. Charged only when the full text is found.",
"default": false
},
"onlyNew": {
"title": "Only new articles",
"type": "boolean",
"description": "For scheduled runs: skip articles already delivered by previous runs with the same search, country and language. Skipped articles are not charged. The list is kept in the key-value store google-news-seen-articles of your account.",
"default": false
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Not needed: the Actor connects directly and switches to Apify Proxy by itself if Google slows it down."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}