{
"openapi": "3.0.1",
"info": {
"title": "Google News Scraper & API: Articles and News Alerts",
"description": "Google News scraper and API for any keyword in 70+ countries and any language: title, publisher, direct article URL, snippet, publish time, thumbnail and Top stories. Past hour to custom dates, newest first, publisher filters and an only-new mode for scheduled news alerts. Pay per article.",
"version": "1.0",
"x-build-id": "HDouYmVHkBc5LFAAd"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/vncntlabs~google-news-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-vncntlabs-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/vncntlabs~google-news-scraper/runs": {
"post": {
"operationId": "runs-sync-vncntlabs-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/vncntlabs~google-news-scraper/run-sync": {
"post": {
"operationId": "run-sync-vncntlabs-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",
"required": [
"keywords"
],
"properties": {
"keywords": {
"title": "Keywords or topics",
"type": "array",
"description": "One search per line (up to 100): a topic (electric vehicles), a company or brand (\"OpenAI\" in quotes for the exact name), a person or a ticker. Quotes, OR and minus work like on Google; operators such as site: are not supported (use the domain filters).",
"items": {
"type": "string"
}
},
"country": {
"title": "Country",
"enum": [
"Argentina",
"Australia",
"Austria",
"Bangladesh",
"Belgium",
"Brazil",
"Bulgaria",
"Canada",
"Chile",
"Colombia",
"Costa Rica",
"Croatia",
"Cyprus",
"Czechia",
"Denmark",
"Dominican Republic",
"Ecuador",
"Egypt",
"Estonia",
"Finland",
"France",
"Germany",
"Greece",
"Hong Kong",
"Hungary",
"Iceland",
"India",
"Indonesia",
"Ireland",
"Israel",
"Italy",
"Japan",
"Kenya",
"Kuwait",
"Latvia",
"Lithuania",
"Luxembourg",
"Malaysia",
"Malta",
"Mexico",
"Morocco",
"Netherlands",
"New Zealand",
"Nigeria",
"Norway",
"Pakistan",
"Peru",
"Philippines",
"Poland",
"Portugal",
"Puerto Rico",
"Qatar",
"Romania",
"Saudi Arabia",
"Serbia",
"Singapore",
"Slovakia",
"Slovenia",
"South Africa",
"South Korea",
"Spain",
"Sweden",
"Switzerland",
"Taiwan",
"Thailand",
"Turkiye",
"Ukraine",
"United Arab Emirates",
"United Kingdom",
"United States",
"Uruguay",
"Vietnam"
],
"type": "string",
"description": "Google News edition (which publishers and stories Google shows).",
"default": "United States"
},
"language": {
"title": "Language",
"type": "string",
"description": "Optional language code (en, de, fr, es, pt-BR...). Defaults to the country's main language."
},
"maxArticlesPerKeyword": {
"title": "Max articles per keyword",
"minimum": 1,
"maximum": 500,
"type": "integer",
"description": "Up to 500. Google usually has a few hundred articles per topic; fewer for narrow searches or short time ranges.",
"default": 100
},
"timeRange": {
"title": "Time range",
"enum": [
"any",
"past_hour",
"past_24_hours",
"past_week",
"past_month",
"past_year",
"custom"
],
"type": "string",
"description": "Only articles published in this period.",
"default": "any"
},
"dateFrom": {
"title": "From date (custom range)",
"type": "string",
"description": "YYYY-MM-DD. Setting a date switches the time range to custom."
},
"dateTo": {
"title": "To date (custom range)",
"type": "string",
"description": "YYYY-MM-DD, inclusive."
},
"sortBy": {
"title": "Sort by",
"enum": [
"relevance",
"date"
],
"type": "string",
"description": "Google News order.",
"default": "relevance"
},
"includeTopStories": {
"title": "Include Top stories",
"type": "boolean",
"description": "Also return the articles in Google's 'Top stories' carousel (marked section: top_stories).",
"default": true
},
"includeDomains": {
"title": "Only these publishers",
"type": "array",
"description": "Optional, e.g. reuters.com, bloomberg.com. Keeps only articles from these sites (subdomains included). Other articles are not charged.",
"items": {
"type": "string"
}
},
"excludeDomains": {
"title": "Exclude publishers",
"type": "array",
"description": "Optional. Drops articles from these sites (not charged).",
"items": {
"type": "string"
}
},
"dedupeAcrossKeywords": {
"title": "Merge duplicates across keywords",
"type": "boolean",
"description": "An article found by several keywords is delivered and charged once, with every keyword in matchedKeywords.",
"default": true
},
"onlyNewArticles": {
"title": "Only new articles (monitoring)",
"type": "boolean",
"description": "For scheduled runs: remembers the articles delivered by previous runs of the same search and returns only new ones. You pay only for new articles. History is kept in your Apify account (key-value store 'google-news-monitor').",
"default": false
},
"monitorId": {
"title": "Monitor name",
"type": "string",
"description": "Optional. Name the monitor to keep its history separate or stable when you edit keywords, e.g. acme-brand-alerts."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}