{ "openapi": "3.0.1", "info": { "title": "Stock News Scraper - Finviz", "description": "Get real-time stock and company news for any ticker symbol. Returns headlines, sources, publication dates, and full article text as clean markdown. Powered by Finviz data. Supports multiple tickers per run. Built for AI agents, LLM pipelines, sentiment analysis, and automated market monitoring.", "version": "0.1", "x-build-id": "1JTpAg1BoIBK8RdoH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/michael_b~finviz-ticker-news/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-michael_b-finviz-ticker-news", "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/michael_b~finviz-ticker-news/runs": { "post": { "operationId": "runs-sync-michael_b-finviz-ticker-news", "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/michael_b~finviz-ticker-news/run-sync": { "post": { "operationId": "run-sync-michael_b-finviz-ticker-news", "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": [ "tickers" ], "properties": { "tickers": { "title": "Ticker Symbols", "type": "string", "description": "Enter one or more stock ticker symbols, separated by commas. Examples: AAPL, TSLA, MSFT, NVDA, AMZN." }, "onlyNew": { "title": "Only new articles since my last run", "type": "boolean", "description": "For scheduled runs: skip articles that an earlier run already gave you, so you get (and pay for) only fresh news. The first run with this on returns everything as usual and starts remembering, per ticker. The memory is a key-value store named finviz-ticker-news-memory in your own Apify account; delete it to start over.", "default": false }, "maxArticles": { "title": "Max Articles Per Ticker", "minimum": 0, "type": "integer", "description": "Maximum number of articles to return per ticker. Finviz stores up to 100 recent articles per ticker. Set to 0 for no limit.", "default": 50 }, "daysBack": { "title": "Days Back", "minimum": 0, "type": "integer", "description": "Only include articles published within the last N days. Set to 0 to include all available articles.", "default": 7 }, "scrapeFullText": { "title": "Extract Full Article Text", "type": "boolean", "description": "Visit each article URL and extract the full text as clean markdown. When disabled, only headlines and metadata are returned (much faster, lower cost).", "default": true }, "maxArticleLength": { "title": "Max Article Length (characters)", "minimum": 0, "type": "integer", "description": "Maximum number of characters to keep per article. Longer articles are truncated. Useful for keeping output size manageable for LLM context windows. Set to 0 for no limit.", "default": 15000 }, "memoryName": { "title": "Separate memory name (optional)", "type": "string", "description": "Leave empty. Only for 'Only new articles': if two schedules ask for the same tickers and each one should get every new article, give each schedule its own name here (for example telegram-bot). Letters, digits and hyphens." } } }, "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 } } } } } } } } } }