{ "openapi": "3.0.1", "info": { "title": "Google News Scraper | Headlines and Real URLs", "description": "Scrape Google News by keyword, topic or URL in any language and country. Each row has the headline, publisher, date and the real article URL decoded from the Google link. Date ranges go past the 100-result cap. No browser. $1 per 1,000 articles.", "version": "1.0", "x-build-id": "OHqxYGd2DaEVDU1By" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/atesen-software~google-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-atesen-software-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/atesen-software~google-news-scraper/runs": { "post": { "operationId": "runs-sync-atesen-software-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/atesen-software~google-news-scraper/run-sync": { "post": { "operationId": "run-sync-atesen-software-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 or phrases, one per line. Google News operators work: \"exact phrase\", -exclude, OR, site:reuters.com, intitle:tesla.", "items": { "type": "string" } }, "topics": { "title": "Topics (headlines)", "type": "array", "description": "Optional. Top headlines of a section: TOP, WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH.", "items": { "type": "string" } }, "googleNewsUrls": { "title": "Google News URLs", "type": "array", "description": "Optional. Any news.google.com search, topic or publication URL (e.g. https://news.google.com/topics/...). Its own hl/gl settings are kept.", "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Language code: \"en\" (default), \"tr\", \"de\", \"fr\", \"es\", \"pt-BR\", \"ja\" ..." }, "country": { "title": "Country", "type": "string", "description": "Two-letter country: \"US\" (default), \"GB\", \"TR\", \"DE\", \"IN\" ..." }, "timeRange": { "title": "Time range", "enum": [ "any", "1h", "1d", "7d", "30d", "1y" ], "type": "string", "description": "Only for search queries, ignored when a date range is set.", "default": "any" }, "dateFrom": { "title": "Date from", "type": "string", "description": "Optional. Search queries only. With a date range the Actor searches day by day, so you get far more than Google's 100 results per search." }, "dateTo": { "title": "Date to", "type": "string", "description": "Optional. Default: today (when Date from is set)." }, "maxArticlesPerQuery": { "title": "Max articles per query / topic", "minimum": 0, "maximum": 100000, "type": "integer", "description": "0 = no limit. One Google News search returns up to 100 articles; use a date range for more.", "default": 100 }, "resolveUrls": { "title": "Decode real article URLs", "type": "boolean", "description": "Turn Google News redirect links (news.google.com/rss/articles/...) into the real publisher URL. +$0.50 per 1,000 decoded URLs, only charged when decoding succeeds.", "default": true }, "includeRelatedArticles": { "title": "Include related coverage", "type": "boolean", "description": "For headline clusters, add the other publishers' versions of the same story (title, source, Google link).", "default": false }, "maxConcurrency": { "title": "Queries in parallel", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many queries/topics are scraped at the same time.", "default": 3 } } }, "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 } } } } } } } } } }