{ "openapi": "3.0.1", "info": { "title": "Company News & Announcement Finder", "description": "Find recent public company news, press releases, newsroom posts, blog announcements, product launches, funding updates, partnerships, and expansion signals. One flat, CSV-ready row per announcement. No login or cookies.", "version": "1.0", "x-build-id": "mDMAB2ekjV8j3DhDu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/coregent~company-news-announcement-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-coregent-company-news-announcement-finder", "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/coregent~company-news-announcement-finder/runs": { "post": { "operationId": "runs-sync-coregent-company-news-announcement-finder", "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/coregent~company-news-announcement-finder/run-sync": { "post": { "operationId": "run-sync-coregent-company-news-announcement-finder", "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": { "companies": { "title": "Companies", "type": "array", "description": "Company names or domains to find recent public news and announcements for, for example \"Canva\", \"atlassian.com\", or \"HubSpot\". Provide at least one company OR at least one start URL. Max 500.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct public source pages to scan: newsroom, press, blog, or RSS/Atom feed URLs. Each must be a valid http/https URL.", "default": [], "items": { "type": "string" } }, "searchMode": { "title": "Search mode", "enum": [ "company_sources", "direct_urls_only" ], "type": "string", "description": "\"Company sources\" discovers common public announcement pages (news, press, blog, newsroom) and RSS feeds for each company, with a search fallback. \"Direct URLs only\" skips discovery and scans only your start URLs.", "default": "company_sources" }, "sourceTypes": { "title": "Source types", "type": "array", "description": "Limit which source types are accepted. Leave empty to accept all.", "items": { "type": "string", "enum": [ "newsroom", "press_release", "blog", "rss", "general_news" ], "enumTitles": [ "Newsroom", "Press release", "Blog", "RSS feed", "General news" ] }, "default": [ "newsroom", "press_release", "blog", "rss", "general_news" ] }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum saved announcement rows per run (the global cap). Range 1-5000.", "default": 100 }, "maxResultsPerCompany": { "title": "Max results per company", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum announcements collected per company/input so one company cannot consume the whole run. Range 1-200.", "default": 20 }, "lookbackDays": { "title": "Lookback days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Keep announcements published within this many days when a reliable date is available. Dated rows older than this are filtered out; undated rows are kept. Range 1-3650.", "default": 180 }, "fromDate": { "title": "From date", "type": "string", "description": "Optional fixed lower date bound (YYYY-MM-DD). Overrides lookback days. When set, undated announcements are filtered out.", "default": "" }, "toDate": { "title": "To date", "type": "string", "description": "Optional fixed upper date bound (YYYY-MM-DD). Must be on or after the from date. When set, undated announcements are filtered out.", "default": "" }, "includeKeywords": { "title": "Include keywords", "type": "array", "description": "Keep only announcements matching at least one of these keywords in the title, snippet, URL path, or source name. Leave empty to keep all.", "default": [], "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Remove announcements matching any of these keywords in the title, snippet, URL path, or source name.", "default": [], "items": { "type": "string" } }, "signalCategories": { "title": "Signal categories", "type": "array", "description": "If set, keep only announcements whose detected category matches one of these.", "items": { "type": "string", "enum": [ "funding", "partnership", "product_launch", "expansion", "hiring", "leadership", "customer_win", "event", "financial", "general" ] }, "default": [] }, "deduplicate": { "title": "Deduplicate announcements", "type": "boolean", "description": "Remove duplicate announcements (same canonical/announcement URL or same title) so you are not charged for duplicates.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy configuration. Defaults to Apify Proxy enabled. Apify Residential is NOT supported and will fail the run at startup; if you need residential routing, supply your own provider via Custom proxy URLs (proxyUrls).", "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 } } } } } } } } } }