{ "openapi": "3.0.1", "info": { "title": "Google News API - Headlines, Source, Date, No Login", "description": "Google News API: articles for any keyword, topic section, city or Google News link, in any country and language. Up to 5,000 per search, custom dates, the publisher's own link, picture and summary. No API key. $2 per 1,000 articles.", "version": "0.1", "x-build-id": "Ya80b85cqSAdHnaM3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/om_kh~google-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-om_kh-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/om_kh~google-news-scraper/runs": { "post": { "operationId": "runs-sync-om_kh-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/om_kh~google-news-scraper/run-sync": { "post": { "operationId": "run-sync-om_kh-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", "required": [ "queries" ], "properties": { "queries": { "title": "Search queries", "type": "array", "description": "Keywords, brands, companies or people to search on Google News, one per line. Google operators work: \"exact phrase\", OR, -word, site:reuters.com, intitle:word.", "items": { "type": "string" } }, "topics": { "title": "Topic sections (optional)", "type": "array", "description": "Google News sections of the chosen country edition: the headlines Google shows there right now.", "items": { "type": "string", "enum": [ "TOP", "WORLD", "NATION", "BUSINESS", "TECHNOLOGY", "ENTERTAINMENT", "SPORTS", "SCIENCE", "HEALTH" ], "enumTitles": [ "Top stories", "World", "Nation", "Business", "Technology", "Entertainment", "Sports", "Science", "Health" ] } }, "locations": { "title": "Local news for places (optional)", "type": "array", "description": "Cities or regions: Montreal, Texas, Lyon. Returns Google News' local headlines for each.", "items": { "type": "string" } }, "topicUrls": { "title": "Google News links (optional)", "type": "array", "description": "Any news.google.com topic, section, publication or search link: its articles are returned.", "items": { "type": "string" } }, "country": { "title": "Country edition", "type": "string", "description": "Two-letter country code of the Google News edition, e.g. US, GB, FR, DE, IN, BR, CA. Default US.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code of the edition, e.g. en, fr, de, es, pt. Default en. Combine with country: FR + fr = Google News France.", "default": "en" }, "timeRange": { "title": "Time range", "enum": [ "", "1h", "1d", "7d", "30d", "1y" ], "type": "string", "description": "Only articles from the last hour/day/week/month/year (Google's own 'when:' filter). Empty = any time.", "default": "" }, "dateFrom": { "title": "From date (optional)", "type": "string", "description": "YYYY-MM-DD. With a start or end date, the time range above is ignored." }, "dateTo": { "title": "To date (optional)", "type": "string", "description": "YYYY-MM-DD, included. Default: today." }, "maxArticlesPerQuery": { "title": "Max articles per search", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Google News gives 100 articles per search. Above 100, the period (time range or dates; last 30 days when none is set) is cut into smaller date windows until the number is reached. Newest first.", "default": 100 }, "sourceDomains": { "title": "Only these publishers (optional)", "type": "array", "description": "Domains to keep: reuters.com, bbc.com, lemonde.fr.", "items": { "type": "string" } }, "excludeDomains": { "title": "Exclude these publishers (optional)", "type": "array", "description": "Domains to leave out.", "items": { "type": "string" } }, "decodeUrls": { "title": "Get the publisher's article link", "type": "boolean", "description": "Google News links point to news.google.com. Turn on to also get the article's own address on the publisher's site (articleUrl). Slower: about 1 second per 10 articles.", "default": false }, "includeArticleDetails": { "title": "Get picture and summary", "type": "boolean", "description": "Open each article's page for its picture, summary, author and site name. Includes the publisher's link. Publishers that block robots return empty fields.", "default": false }, "currentItems": { "title": "Bring your own items (optional)", "type": "array", "description": "Skip the chained fetch and pass records directly (no upstream call, no fetch fee).", "default": [] }, "maxTotalChargeUsd": { "title": "Maximum Vigia charge (USD)", "minimum": 0, "type": "number", "description": "Hard maximum amount that this run may charge." }, "sources": { "title": "Data source (informational)", "type": "array", "description": "Declare every upstream source before this run. Each item needs name, authorization, and estimated_cost_usd.", "default": [ { "name": "Google News official RSS feed (first-party, no third-party scraper)", "authorization": "public_official", "estimated_cost_usd": 0 } ] }, "monitorEnabled": { "title": "Monitor only new results", "type": "boolean", "description": "The first monitored run stores a free baseline. Later runs deliver and charge only new results.", "default": false }, "monitorId": { "title": "Monitor ID (optional)", "type": "string", "description": "Pins the persistent baseline to a name of your choice, so separate targets never share state. Leave empty to derive it automatically.", "default": "" } } }, "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 } } } } } } } } } }