{ "openapi": "3.0.1", "info": { "title": "Google News Scraper", "description": "Scrape Google News by search term, topic or link. Get headline, publisher, publish date and the real article URL, plus snippet, image, author and keywords when available. Filter by date, country, language and publisher. Bulk input, live results, no login needed.", "version": "1.0", "x-build-id": "hgc54GyohCe6xiriB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/insights_data~google-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-insights_data-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/insights_data~google-news-scraper/runs": { "post": { "operationId": "runs-sync-insights_data-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/insights_data~google-news-scraper/run-sync": { "post": { "operationId": "run-sync-insights_data-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": { "urls": { "title": "🔗 Google News links", "type": "array", "description": "Google News search or topic links, one per line. Search links, topic links and the home page are understood. Each link is turned into a search or topic.", "items": { "type": "string" } }, "queries": { "title": "🔎 Search terms", "type": "array", "description": "One search term per line, as you would type it in Google News. Quotes, OR, intitle: and -word work.", "items": { "type": "string" } }, "topics": { "title": "📚 Topics", "type": "array", "description": "Headline sections to read in addition to the searches above.", "items": { "type": "string", "enum": [ "top", "world", "nation", "business", "technology", "entertainment", "sports", "science", "health" ], "enumTitles": [ "Top stories", "World", "Nation", "Business", "Technology", "Entertainment", "Sports", "Science", "Health" ] } }, "maxItems": { "title": "🔢 Maximum articles", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Total number of articles to save across everything above. 0 means as many as can be found. Free plan users are limited to 10 articles per run; paid plans have no limit.", "default": 10 }, "country": { "title": "📍 Country edition", "type": "string", "description": "Two-letter country code of the Google News edition, for example US, GB or DE.", "default": "US" }, "language": { "title": "🔤 News language", "type": "string", "description": "Language of the news, for example en, fr, de or pt-BR.", "default": "en" }, "timePeriod": { "title": "⏳ Time period", "enum": [ "any", "1h", "24h", "7d", "2w", "3m", "1y" ], "type": "string", "description": "Only articles published within this period. A date range below takes priority.", "default": "any" }, "dateFrom": { "title": "📆 From date", "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "First day to include, format YYYY-MM-DD." }, "dateTo": { "title": "🏁 To date", "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Last day to include (inclusive), format YYYY-MM-DD." }, "sort": { "title": "🔃 Sort order", "enum": [ "relevance", "date" ], "type": "string", "description": "Google's relevance order, or newest first.", "default": "relevance" }, "includeSites": { "title": "✅ Only these publishers", "type": "array", "description": "Keep only articles from these sites, for example bbc.com or reuters.com. Leave empty for all publishers.", "items": { "type": "string" } }, "excludeSites": { "title": "🚫 Skip these publishers", "type": "array", "description": "Never return articles from these sites, for example pinterest.com.", "items": { "type": "string" } }, "resolveUrls": { "title": "🔓 Real publisher links", "type": "boolean", "description": "Return the publisher's own article URL instead of the news.google.com link. Slower, but gives the real domain.", "default": true }, "articleDetails": { "title": "📝 Article details", "type": "boolean", "description": "Open each article for its snippet, image, author, keywords, section and times. Some publishers do not allow this and those fields stay empty.", "default": true }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Requests start without a proxy. If Google refuses them, the run moves to a datacenter proxy and then to a residential proxy automatically.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }