{ "openapi": "3.0.1", "info": { "title": "RSS Feed Finder: Discover RSS & Atom Feeds of Any Website", "description": "Find the RSS, Atom and JSON feeds of any list of websites, then read each feed: feed URL, type, title, latest posts with dates and links, and how many posts in the last 30 days. Works from bare domains; tries common feed paths when a site doesn't declare one.", "version": "0.1", "x-build-id": "Q4zMfQ6qFIygSGHV2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/redfoxscout~rss-feed-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-redfoxscout-rss-feed-finder", "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/redfoxscout~rss-feed-finder/runs": { "post": { "operationId": "runs-sync-redfoxscout-rss-feed-finder", "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/redfoxscout~rss-feed-finder/run-sync": { "post": { "operationId": "run-sync-redfoxscout-rss-feed-finder", "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": { "urls": { "title": "Websites", "type": "array", "description": "Websites or domains, one per line (e.g. techcrunch.com). The home page is checked for feeds. Or use \"Websites from another Actor\" below.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (optional)", "type": "array", "description": "Same as the list above, in Apify's standard start-URL format (handy when another tool or Actor passes startUrls).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "datasetId": { "title": "Websites from another Actor (optional)", "type": "string", "description": "Check the websites in another Actor run's results, e.g. Google Maps Scraper or any lead list. Pick the dataset here, or in an Actor-to-Actor integration set it to {{resource.defaultDatasetId}}. Its websites are added to the list above." }, "datasetUrlField": { "title": "Field with the website", "type": "string", "description": "The dataset field that holds the website or URL, e.g. website (Google Maps Scraper), url or domain. Dot paths like contact.website work. If it is empty, website, url and domain are tried.", "default": "website" }, "maxDatasetItems": { "title": "Max dataset rows", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Read at most this many rows from that dataset.", "default": 10000 }, "monitorName": { "title": "Change alert name (optional)", "type": "string", "description": "Name this list (e.g. \"clients-weekly\") to compare each run with the previous run of the same name. Every row then gets changeStatus (new, changed or unchanged) and changedFields. Best on an Apify schedule." }, "onlyChanges": { "title": "Only new and changed sites in the results", "type": "boolean", "description": "Needs a change alert name. Unchanged sites are still checked and charged as usual, but left out of the results, so each run's dataset is your change report.", "default": false }, "outputMode": { "title": "Output", "enum": [ "sites", "articles" ], "type": "string", "description": "Sites returns one row per website with its feed details and latest posts. Articles returns one row per post, ready for a feed reader, newsletter or AI agent; articles are charged per row.", "default": "sites" }, "includeContent": { "title": "Include full post text", "type": "boolean", "description": "Articles output only: add each post's full text as plain text (up to 20,000 characters). Off keeps rows small.", "default": false }, "includeKeywords": { "title": "Keep posts with these words", "type": "array", "description": "Keep only posts whose title or summary contains at least one of these words (case-insensitive, whole words). Empty = keep all posts. Applies to both outputs.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Drop posts with these words", "type": "array", "description": "Drop posts whose title or summary contains any of these words (case-insensitive, whole words). Empty = drop nothing. Applies to both outputs.", "items": { "type": "string" } }, "publishedAfter": { "title": "Published on or after (optional)", "type": "string", "description": "Only posts published on or after this date or time, e.g. 2026-10-01 or 2026-10-01T09:00:00Z. A time without a timezone is UTC. Posts with no date are left out when this is set." }, "maxFeeds": { "title": "Max feeds per site", "minimum": 1, "maximum": 10, "type": "integer", "description": "Read at most this many feeds per website (declared feeds first). Comment feeds are skipped.", "default": 3 }, "maxItemsPerFeed": { "title": "Latest posts per feed", "minimum": 0, "maximum": 50, "type": "integer", "description": "How many of the newest posts that pass the filters to return for each feed (sites output: title, link, date; articles output: one row each). 0 = feed details only.", "default": 5 }, "maxConcurrency": { "title": "Sites in parallel", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many sites to check at once.", "default": 20 }, "requestTimeoutSecs": { "title": "Timeout per site (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Give up on a site after this long.", "default": 30 }, "proxyConfiguration": { "title": "Proxy (optional)", "type": "object", "description": "Off by default. Turn on if some sites block or rate-limit the checks.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }