{ "openapi": "3.0.1", "info": { "title": "RSS Feed Reader & Finder (RSS, Atom, JSON Feed)", "description": "RSS feed reader and feed finder: read RSS, Atom and JSON Feed items, or discover the feed of any website. Keyword and date filters, podcast enclosures, only-new-items mode for monitoring. Never charges for a failed or empty result.", "version": "0.1", "x-build-id": "2Ik9MukeB20XngIfF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pavel.tashev~rss-feed-reader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pavel.tashev-rss-feed-reader", "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/pavel.tashev~rss-feed-reader/runs": { "post": { "operationId": "runs-sync-pavel.tashev-rss-feed-reader", "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/pavel.tashev~rss-feed-reader/run-sync": { "post": { "operationId": "run-sync-pavel.tashev-rss-feed-reader", "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": [ "urls" ], "properties": { "urls": { "title": "Feed URLs or websites", "maxItems": 1000, "type": "array", "description": "RSS, Atom or JSON Feed URLs, or plain websites and domains (for example theverge.com). For websites, the feed is found automatically from the page's feed links and the usual feed locations. Up to 1,000 URLs per run; any extra entries are skipped and reported in the run status.", "items": { "type": "string" } }, "mode": { "title": "Mode", "enum": [ "items", "discover" ], "type": "string", "description": "Read feed items, or only list the feeds found on each website (one result per feed, with its title, type and item count).", "default": "items" }, "maxItemsPerFeed": { "title": "Maximum items per feed", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many items from each feed (counted after filters). Most feeds list their 10–100 newest items.", "default": 100 }, "maxFeedsPerWebsite": { "title": "Feeds per website", "minimum": 1, "maximum": 20, "type": "integer", "description": "When a website advertises several feeds (for example posts, podcasts and comments), use up to this many. Applies to both modes: \"Read feed items\" reads this many feeds per website and \"Find feeds only\" lists this many. Raise it to see every feed a site publishes. Comment feeds are used only when nothing else exists.", "default": 1 }, "keywords": { "title": "Keywords", "type": "string", "description": "Comma-separated keywords. An item is kept when its title, summary, content or categories contain all words of at least one keyword, for example \"electric cars, battery\". Leave empty for all items." }, "publishedAfter": { "title": "Published after", "type": "string", "description": "Keep only items published on or after a date (2026-09-01) or within a period (\"24 hours\", \"7 days\", \"2 weeks\"). Items without a date are dropped when this is set." }, "onlyNewItems": { "title": "Only new items (for scheduled runs)", "type": "boolean", "description": "Skip items saved by earlier runs, and ask servers whether the feed changed since last time. Remembered items are kept in a key-value store named rss-feed-reader-state in your own Apify account. Skipped items are not charged.", "default": false }, "deduplicate": { "title": "Remove duplicates across feeds", "type": "boolean", "description": "Save a story once even when several feeds carry it (matched by link, GUID, or title and date). Duplicates are not charged.", "default": true }, "includeContent": { "title": "Include full content", "type": "boolean", "description": "Add the full article body when the feed provides it (content:encoded, Atom content, JSON Feed content).", "default": false }, "contentFormat": { "title": "Content format", "enum": [ "text", "html" ], "type": "string", "description": "Full content as plain text or as the original HTML.", "default": "text" }, "summaryMaxLength": { "title": "Summary length", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum characters of the plain-text summary. Use 0 for the full summary.", "default": 500 } } }, "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 } } } } } } } } } }