{ "openapi": "3.0.1", "info": { "title": "RSS & Atom Feed Reader: Bulk, Only New Items, Auto-Discovery", "description": "Read many RSS, Atom and JSON feeds into one clean dataset. Paste feed or website URLs (feeds are found automatically), get only items that are new since the last run, filter by date and keywords. Ideal for news, blog and podcast monitoring with alerts.", "version": "0.0", "x-build-id": "e3g0KkhfKEGCFAr1m" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/charlesmarkette~rss-atom-feed-reader-only-new-items/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-charlesmarkette-rss-atom-feed-reader-only-new-items", "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/charlesmarkette~rss-atom-feed-reader-only-new-items/runs": { "post": { "operationId": "runs-sync-charlesmarkette-rss-atom-feed-reader-only-new-items", "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/charlesmarkette~rss-atom-feed-reader-only-new-items/run-sync": { "post": { "operationId": "run-sync-charlesmarkette-rss-atom-feed-reader-only-new-items", "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": "Feed or website URLs", "type": "array", "description": "One per line. RSS, Atom or JSON Feed URLs, or plain website URLs: for a website, the feed is found from the page's tags, or by trying /feed, /rss, /rss.xml, /atom.xml, /feed.xml and /index.xml.", "items": { "type": "string" } }, "maxItemsPerFeed": { "title": "Max items per feed", "minimum": 1, "maximum": 10000, "type": "integer", "description": "The newest items to output from each feed (after the filters below).", "default": 50 }, "onlyNew": { "title": "Only new items", "type": "boolean", "description": "Output only items that weren't in the feed on an earlier run with this setting. The first run outputs the feed's current items (turn on the next option to skip them). Memory: the last 5,000 item IDs per feed, in the key-value store 'rss-feed-reader-state'.", "default": false }, "skipExistingOnFirstRun": { "title": "Skip existing items on the first run", "type": "boolean", "description": "With 'Only new items': the first run for a feed only remembers its current items and outputs nothing, so later runs output only items published after you started monitoring.", "default": false }, "stateKey": { "title": "Memory name", "type": "string", "description": "Optional. Runs with the same memory name share their 'only new' memory. By default each saved task has its own memory (and changing the keyword filters starts a fresh one). Letters, digits, '-', '_' and '.'." }, "since": { "title": "Published after", "type": "string", "description": "Optional. Only items published (or, if no publish date, updated) after this: a date like 2026-10-01 or 2026-10-01T08:00:00Z (UTC), or a period like '7 days', '24 hours', '2 weeks'. Items with no date at all are left out when this is set." }, "keywords": { "title": "Keywords", "type": "array", "description": "Optional. Keep only items whose title or summary contains any of these (case-insensitive, plain substring match).", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Optional. Leave out items whose title or summary contains any of these (case-insensitive).", "items": { "type": "string" } }, "includeContentHtml": { "title": "Include full content HTML", "type": "boolean", "description": "Add a contentHtml column with the item's full HTML content (sanitized: scripts and event handlers removed; cut at 1,000,000 characters). Rows get much larger.", "default": false }, "concurrency": { "title": "Parallel feeds", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many feeds to read at the same time (1–20). Each website still gets at most 2 requests at a time.", "default": 5 }, "maxResults": { "title": "Max output rows", "minimum": 1, "type": "integer", "description": "Optional cap on output rows for the whole run (items plus any feed error rows)." } } }, "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 } } } } } } } } } }