{ "openapi": "3.0.1", "info": { "title": "Google News Scraper: Articles, Real URLs & Full Text", "description": "Scrape Google News by keyword, topic or top headlines in any country and language. Get title, publisher, publish time, the real article URL (decoded from Google links) and optionally the full article text, author and image.", "version": "0.1", "x-build-id": "uY1sKMB0G9Sf7d70v" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tindacloud~google-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tindacloud-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/tindacloud~google-news-scraper/runs": { "post": { "operationId": "runs-sync-tindacloud-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/tindacloud~google-news-scraper/run-sync": { "post": { "operationId": "run-sync-tindacloud-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, brands, people or Google News operators (\"exact phrase\", OR, -exclude, intitle:). Each query is one feed.", "items": { "type": "string" } }, "timeRange": { "title": "Published within", "enum": [ "any", "1h", "1d", "7d", "1m", "1y" ], "type": "string", "description": "Applies to search queries.", "default": "any" }, "sites": { "title": "Only from these sites (optional)", "type": "array", "description": "Limit search queries to publisher domains, e.g. reuters.com, bbc.co.uk.", "items": { "type": "string" } }, "topics": { "title": "Topics", "type": "array", "description": "Google News topic sections (current headlines).", "items": { "type": "string", "enum": [ "WORLD", "NATION", "BUSINESS", "TECHNOLOGY", "ENTERTAINMENT", "SPORTS", "SCIENCE", "HEALTH" ], "enumTitles": [ "World", "Nation", "Business", "Technology", "Entertainment", "Sports", "Science", "Health" ] } }, "topHeadlines": { "title": "Include top headlines", "type": "boolean", "description": "Add the current top stories for the country. Used automatically if no query or topic is given.", "default": false }, "language": { "title": "Language", "type": "string", "description": "Language code, e.g. en, es, de, fr, ja, ko, pt-BR.", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Two-letter country edition, e.g. US, GB, IN, DE, JP, KR, BR.", "default": "US" }, "decodeUrls": { "title": "Resolve real article URLs", "type": "boolean", "description": "Convert Google News redirect links into the publisher's original article URL.", "default": true }, "includeArticleText": { "title": "Include full article text", "type": "boolean", "description": "Download each article and extract the main text, author, image and description. Paywalled sites may return only a teaser. Same price.", "default": false }, "includeRelatedCoverage": { "title": "Include related coverage", "type": "boolean", "description": "Other outlets' headlines on the same story, as listed by Google News.", "default": true }, "maxArticlesPerQuery": { "title": "Max articles per query/topic", "minimum": 1, "type": "integer", "description": "Google News feeds return up to about 100 articles.", "default": 100 }, "onlyNewArticles": { "title": "Only articles that are new", "type": "boolean", "description": "Monitoring mode. Remembers the articles you already pulled for each query and returns only the ones published since. Run it hourly to track a topic — you pay only for new articles.", "default": false }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Stop after this many articles. You are charged per article.", "default": 500 }, "proxy": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy works for Google News.", "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 } } }, "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 } } } } } } } } } }