{ "openapi": "3.0.1", "info": { "title": "Stock News API Scraper", "description": "Extract MarketWatch top stories and real-time bulletins as structured news: headline, summary, byline, an ISO 8601 publication time, and the company tickers each story mentions. Export data, run via API, schedule and monitor runs, or integrate with other tools.", "version": "0.0", "x-build-id": "ui1DK4lQcwyyXVVwM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/publicmoney~marketwatch-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-publicmoney-marketwatch-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/publicmoney~marketwatch-scraper/runs": { "post": { "operationId": "runs-sync-publicmoney-marketwatch-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/publicmoney~marketwatch-scraper/run-sync": { "post": { "operationId": "run-sync-publicmoney-marketwatch-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", "properties": { "feeds": { "title": "📰 Feeds", "maxItems": 20, "type": "array", "description": "Which MarketWatch feeds to read, one per line. Top stories and bulletins are the two that are still updated, and bulletins carries short market-moving headlines within minutes. Market pulse and real-time headlines are still served but Dow Jones stopped adding to them in 2025, so treat them as an archive. Examples: 'topstories', 'bulletins'. Default is 'topstories', 'bulletins'.", "items": { "type": "string", "enum": [ "topstories", "bulletins", "marketpulse", "realtimeheadlines" ], "enumTitles": [ "Top stories", "Bulletins", "Market pulse", "Real-time headlines" ] }, "default": [ "topstories", "bulletins", "marketpulse", "realtimeheadlines" ] }, "publishedSince": { "title": "📅 Published since", "type": "string", "description": "Only return stories published on or after this date. Leave empty to go by count alone. Example: '2026-09-01'." }, "tickers": { "title": "🏷️ Only stories mentioning these tickers", "maxItems": 50, "type": "array", "description": "Return only stories that mention one of these tickers or assets (AAPL, BTC, NVDA). Leave empty to get the whole feed. Matching reads the article text, so keep 'Fetch the full article text' on — with it off, far fewer stories resolve a ticker.", "default": [], "items": { "type": "string" } }, "articlesPerFeed": { "title": "🔢 Articles per feed", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many stories to return per feed, newest first. The feed carries a rolling window, so a value above what it holds returns everything available. Counted per feed, so four feeds at 50 is up to 200 stories. Use Max items to cap the run total.", "default": 50 }, "onlyNew": { "title": "🆕 Only stories not returned before", "type": "boolean", "description": "Skip stories an earlier run of this Actor already returned, so a scheduled run pays only for what is new. Off by default, so a one-off run returns everything in range.", "default": false }, "fullText": { "title": "📄 Fetch the full article text", "type": "boolean", "description": "Read each story's own page so `articleBody` holds the real article text rather than the feed's one-sentence teaser. Turn off for a faster, cheaper run that takes only what the feed publishes. On by default.", "default": true }, "maxItems": { "title": "🔢 Max items", "minimum": 0, "maximum": 10000, "type": "integer", "description": "A hard cap on the stories a run returns across every feed together, applied on top of Articles per feed. 0 means no cap. Example: four feeds at 50 each with Max items 100 returns 100, not 200.", "default": 0 } } }, "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 } } } } } } } } } }