{ "openapi": "3.0.1", "info": { "title": "Google News Scraper", "description": "Scrape Google News headlines by keyword, topic, city or any Google News URL in any language and country. Every record has the title, publisher, publish time, related coverage and the resolved publisher URL - no extra charge for URL resolution.", "version": "1.0", "x-build-id": "a2rXK4nmHFUeyEB3y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mdcurt~google-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mdcurt-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/mdcurt~google-news-scraper/runs": { "post": { "operationId": "runs-sync-mdcurt-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/mdcurt~google-news-scraper/run-sync": { "post": { "operationId": "run-sync-mdcurt-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 Google News for, one per line. Google News search operators work: `\"exact phrase\"`, `OR`, `-excluded`, `site:reuters.com`, `intitle:`, `allintext:`, `when:7d`, `before:2026-01-01`, `after:2026-01-01`. Each query becomes one feed of up to ~100 newest matching stories.", "default": [ "artificial intelligence" ], "items": { "type": "string" } }, "topics": { "title": "Topics (headline sections)", "type": "array", "description": "Google News headline sections to pull: Top stories, World, Nation (local country), Business, Technology, Entertainment, Sports, Science, Health.", "items": { "type": "string", "enum": [ "TOP", "WORLD", "NATION", "BUSINESS", "TECHNOLOGY", "ENTERTAINMENT", "SPORTS", "SCIENCE", "HEALTH" ], "enumTitles": [ "Top stories", "World", "Nation", "Business", "Technology", "Entertainment", "Sports", "Science", "Health" ] }, "default": [] }, "locations": { "title": "Local news locations", "type": "array", "description": "Cities, regions or countries for Google News local headline feeds, e.g. `Chicago`, `Bavaria`, `Sydney NSW`. Spell them the way Google News shows them.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Google News URLs", "type": "array", "description": "Any Google News page or RSS URL copied from the browser: a search (`https://news.google.com/search?q=...`), a topic (`/topics/...`), a section (`/headlines/section/...`) or an RSS feed (`/rss/...`). They are converted to RSS automatically. Non-Google-News URLs are ignored.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "language": { "title": "Language (hl)", "type": "string", "description": "Google News interface language / edition language code, e.g. `en-US`, `en-GB`, `de`, `fr`, `es`, `pt-BR`, `ja`, `hi`. Combined with Country it selects the Google News edition.", "default": "en-US" }, "country": { "title": "Country (gl)", "type": "string", "description": "Two-letter country code of the Google News edition, e.g. `US`, `GB`, `DE`, `IN`, `BR`, `AU`. Leave empty to derive it from the language (en-US → US).", "default": "US" }, "timeRange": { "title": "Time range (search queries only)", "enum": [ "any", "1h", "1d", "7d", "1m", "1y" ], "type": "string", "description": "Restrict search queries to stories published within the last hour, day, 7 days, month or year. Ignored for topics, locations and start URLs, and for queries that already contain a `when:` operator.", "default": "any" }, "maxItems": { "title": "Max articles (total)", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many unique articles across all feeds. You pay per article returned.", "default": 100 }, "maxItemsPerFeed": { "title": "Max articles per feed", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap per query / topic / location / URL. Google News returns at most about 100 stories per feed.", "default": 100 }, "resolveUrls": { "title": "Resolve publisher URLs", "type": "boolean", "description": "Google News links point at news.google.com redirect pages. When enabled, the Actor resolves each one to the publisher's own article URL (`url` field). Costs two extra lightweight requests per article but no extra charge. Turn off for a faster, Google-links-only run.", "default": true }, "includeRelated": { "title": "Include related coverage", "type": "boolean", "description": "Keep the `relatedArticles` array (other publishers covering the same story, as shown in Google News) on each record.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxies to use. Apify datacenter proxies are enough for normal volumes; switch to residential if Google starts rate limiting large runs.", "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 } } } } } } } } } }