{ "openapi": "3.0.1", "info": { "title": "Advanced News Scraper", "description": "Extract the latest news articles with custom search queries, providing all the information, including article titles, sources, publication dates, full article text, and an AI-generated summary.", "version": "0.0", "x-build-id": "U1cCebivKTKGjvfjq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dorcy~advanced-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dorcy-advanced-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/dorcy~advanced-news-scraper/runs": { "post": { "operationId": "runs-sync-dorcy-advanced-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/dorcy~advanced-news-scraper/run-sync": { "post": { "operationId": "run-sync-dorcy-advanced-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": [ "query" ], "properties": { "query": { "title": "Search Query", "type": "string", "description": "Query terms for the News", "default": "Tech OR Startup" }, "blacklistedWords": { "title": "Blacklisted Words", "type": "array", "description": "The words if found anywhere in the story the article will be skipped.", "items": { "type": "string" } }, "limit": { "title": "Article Limit", "type": "integer", "description": "The limit to the number of articles retrieved", "default": 10 }, "includeSummary": { "title": "Include AI Summary", "type": "boolean", "description": "Include ai summaries with the OpenAI key you provide below, this will be a title and description.", "default": false }, "openaiKey": { "title": "OpenAI Secret API Key", "type": "string", "description": "If you want summaries include your OpenAI secret key. Here is how to find it https://help.openai.com/en/articles/4936850-where-do-i-find-my-api-key", "default": "sk-...jkdns" }, "when": { "title": "Time Frame", "enum": [ "1h", "12h", "1d", "7d", "30d", "3d", "14d", "2m", "3m", "6m", "12m" ], "type": "string", "description": "Specifies the time range for the published date and time of news articles in the RSS feed. Use 'h' for hours (up to 101 hours), 'd' for days, and 'm' for months (up to 48 months). For example, '1d' represents a 1-day time frame. Note: If the keyword is very niche or if the published dates of articles have recently changed, some stories outside of the specified timeline may appear.", "default": "1d" }, "gl": { "title": "Region", "enum": [ "US", "GB", "CA" ], "type": "string", "description": "Country code for the news region", "default": "US" }, "hl": { "title": "Language", "enum": [ "en-US", "en-GB", "es-ES" ], "type": "string", "description": "Language for the news articles", "default": "en-US" }, "ceid": { "title": "Edition", "enum": [ "US:en", "GB:en", "CA:en", "CA:fr" ], "type": "string", "description": "Edition or regional targeting of the news", "default": "US:en" } } }, "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 } } } } } } } } } }