{ "openapi": "3.0.1", "info": { "title": "Google News Scraper", "description": "Articles from Google News searches, topic sections and front pages in any language edition, with the publisher's own link, date, image, description and optionally the full article text. A date range runs each query day by day to get past 100 results per search.", "version": "0.1", "x-build-id": "7gV9FcfGicgGiyXEO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deriverge~google-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deriverge-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/deriverge~google-news-scraper/runs": { "post": { "operationId": "runs-sync-deriverge-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/deriverge~google-news-scraper/run-sync": { "post": { "operationId": "run-sync-deriverge-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 in Google News. Google's operators work: \"exact phrase\", site:reuters.com to limit to a publisher, -word to exclude, when:7d for the last week.", "items": { "type": "string" } }, "topics": { "title": "Topics", "type": "array", "description": "Google News topic sections for the chosen language and country.", "items": { "type": "string", "enum": [ "WORLD", "NATION", "BUSINESS", "TECHNOLOGY", "ENTERTAINMENT", "SPORTS", "SCIENCE", "HEALTH" ], "enumTitles": [ "World", "Nation", "Business", "Technology", "Entertainment", "Sports", "Science", "Health" ] } }, "topStories": { "title": "Top stories", "type": "boolean", "description": "Include the front page of the chosen edition.", "default": false }, "feeds": { "title": "Extra RSS or Atom feeds", "type": "array", "description": "Any feed URLs to read alongside Google News, for example a publisher's own RSS. Same output format, same deduplication.", "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code of the Google News edition (en, de, fr, cs, es, pt, ja...).", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code of the Google News edition (US, GB, DE, CZ, BR, IN...).", "default": "US" }, "maxItemsPerSource": { "title": "Maximum articles per query, topic or feed", "minimum": 1, "maximum": 100, "type": "integer", "description": "Google News returns up to 100 items per query.", "default": 100 }, "resolveLinks": { "title": "Resolve Google redirect links to the real article URL", "type": "boolean", "description": "Google News links point to news.google.com. When on, the actor decodes or follows each link to the publisher's own URL. Turn off for faster runs if you only need titles and sources.", "default": true }, "articleDetails": { "title": "Read article pages", "type": "boolean", "description": "Opens each article on the publisher's site and adds its image and real description (Google News itself only gives the headline). Pages are read only where robots.txt allows it; sites with bot protection or a paywall are skipped. Free of charge, but a run takes longer.", "default": false }, "articleText": { "title": "Include article text", "type": "boolean", "description": "Also returns the full text of each article as plain text in articleText, up to 50,000 characters. Turns on Read article pages. Paywalled articles give no text.", "default": false }, "publishedWithinHours": { "title": "Published within the last N hours", "minimum": 1, "type": "integer", "description": "Drop articles older than this. Leave empty for no limit." }, "newOnly": { "title": "Return only articles that appeared since the last run", "type": "boolean", "description": "Keeps a snapshot per watch name (or per saved task) and returns only articles not seen in the previous run. Schedule it hourly or daily and you get a clean news feed for a brand, a competitor or a topic.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of the snapshot used by new-only mode, for example \"brand-mentions\". Runs from a saved task get a snapshot automatically." }, "dateFrom": { "title": "From date (YYYY-MM-DD)", "type": "string", "description": "Start of the period to cover. Google News returns at most 100 items per query, so when a date range is set every query is split into day-sized windows and the results are merged and deduplicated. A week of one busy keyword returned more than 600 articles instead of 100 in September 2026." }, "dateTo": { "title": "To date (YYYY-MM-DD)", "type": "string", "description": "End of the period, inclusive. Ranges longer than 92 days are cut to 92 days." } } }, "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 } } } } } } } } } }