{ "openapi": "3.0.1", "info": { "title": "News Headlines Monitor: keyword news from 115+ publishers", "description": "Monitor news by keyword across 115+ major publishers in 20 countries (BBC, Guardian, NYT, CNBC, Times of India, Le Monde, Spiegel, ABC Australia...) from their official RSS feeds: headline, link, summary, date, source, image. Deduplicated, newest first, alert mode.", "version": "0.1", "x-build-id": "eDjM60X5f8AoHhQUf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/larkmoor~news-headlines-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-larkmoor-news-headlines-monitor", "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/larkmoor~news-headlines-monitor/runs": { "post": { "operationId": "runs-sync-larkmoor-news-headlines-monitor", "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/larkmoor~news-headlines-monitor/run-sync": { "post": { "operationId": "run-sync-larkmoor-news-headlines-monitor", "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": { "keywords": { "title": "Keywords", "type": "array", "description": "Return headlines that mention any of these words or phrases (title and summary; whole words, case-insensitive). Put a phrase in quotes or just type it. Empty = all headlines.", "items": { "type": "string" } }, "matchAllKeywords": { "title": "Require all keywords", "type": "boolean", "description": "Only keep headlines that mention every keyword.", "default": false }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop headlines that mention any of these words (e.g. sponsored, horoscope).", "items": { "type": "string" } }, "regions": { "title": "Countries / regions", "type": "array", "description": "Which publisher groups to read. Default: United States, United Kingdom and World.", "items": { "type": "string", "enum": [ "US", "UK", "WORLD", "TECH", "IN", "ID", "NG", "AU", "CA", "PH", "ZA", "KE", "PK", "DE", "FR", "ES", "IT", "BR", "MX", "JP" ], "enumTitles": [ "United States (13 sources)", "United Kingdom (10 sources)", "World (international) (8 sources)", "Tech, science & crypto (14 sources)", "India (7 sources)", "Indonesia (7 sources)", "Nigeria (5 sources)", "Australia (4 sources)", "Canada (2 sources)", "Philippines (4 sources)", "South Africa (1 sources)", "Kenya (2 sources)", "Pakistan (3 sources)", "Germany (8 sources)", "France (6 sources)", "Spain (7 sources)", "Italy (3 sources)", "Brazil (5 sources)", "Mexico (4 sources)", "Japan (2 sources)" ] }, "default": [ "US", "UK", "WORLD" ] }, "sources": { "title": "Only these sources", "type": "array", "description": "Optional: keep only sources whose name contains one of these (e.g. BBC, Guardian, CNBC).", "items": { "type": "string" } }, "extraFeeds": { "title": "Extra RSS/Atom feeds", "type": "array", "description": "Add any other public RSS or Atom feed URLs (trade press, local news, company blogs) to the same monitor.", "items": { "type": "string" } }, "languages": { "title": "Languages", "type": "array", "description": "Optional two-letter codes (en, de, fr, es, it, pt, id). Empty = all.", "items": { "type": "string" } }, "searchInSummary": { "title": "Search the summary too", "type": "boolean", "description": "Match keywords in the feed summary as well as the headline.", "default": true }, "maxAgeHours": { "title": "Published in the last N hours", "minimum": 1, "maximum": 720, "type": "integer", "description": "Only headlines published in this window. Default: 24. Most feeds carry the last 1-3 days.", "default": 24 }, "onlyNewSinceLastRun": { "title": "Only headlines not seen in earlier runs", "type": "boolean", "description": "For alerts: remember returned headlines in a named store and return only new ones next time. Schedule the actor every 15-60 minutes.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Name of the memory used by 'only new' mode (letters, digits, dashes). Use one name per monitor.", "default": "default" }, "maxResults": { "title": "Max headlines", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop after this many headlines. Default: 1000.", "default": 1000 } } }, "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 } } } } } } } } } }