{ "openapi": "3.0.1", "info": { "title": "Google News API - Headlines, Source, Date, No Login", "description": "Google News API: every article for any keyword, company or topic, in any country edition and language (US, UK, France, India...), with headline, publisher, date, snippet and link. Time filter from last hour to last year. No API key. Free until 12 Oct 2026, then $2 per 1,000 articles.", "version": "0.1", "x-build-id": "MXgQtdFTanZZdwvIX" }, "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": "News search queries", "type": "array", "description": "Brand names, competitors, or topics to track across Google News. The first run on a query is a free baseline; later runs with the same Monitor ID are billed only for genuinely new articles.", "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": "" }, "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 } } } } } } } } } }