{
  "openapi": "3.0.1",
  "info": {
    "title": "RSS & Atom Feed Monitor - New Items Only + Feed Finder",
    "description": "Read any RSS, Atom, RDF or JSON Feed (or just paste a website / YouTube channel URL and it finds the feed). Schedule it and get only NEW items since the last run, with keyword and date filters. Pay only for new items.",
    "version": "0.1",
    "x-build-id": "aaD9UGDdjsRy6zmej"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/lindenbyte~rss-feed-monitor-new-items/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-lindenbyte-rss-feed-monitor-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/lindenbyte~rss-feed-monitor-new-items/runs": {
      "post": {
        "operationId": "runs-sync-lindenbyte-rss-feed-monitor-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/lindenbyte~rss-feed-monitor-new-items/run-sync": {
      "post": {
        "operationId": "run-sync-lindenbyte-rss-feed-monitor-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",
        "required": [
          "startUrls"
        ],
        "properties": {
          "startUrls": {
            "title": "Feed or website URLs",
            "type": "array",
            "description": "RSS, Atom, RDF or JSON Feed URLs, or any website / blog / news page / YouTube channel URL. For a web page the feed is found automatically (<link rel=\"alternate\"> tags, then common paths like /feed and /rss.xml). YouTube: youtube.com/channel/UC..., youtube.com/@handle and playlist URLs work.",
            "items": {
              "type": "string"
            }
          },
          "onlyNewItems": {
            "title": "Only NEW items since the last run (monitoring mode)",
            "type": "boolean",
            "description": "Remembers which items each feed already had (in your named key-value store 'rss-feed-monitor-state') and outputs only items that were not there on the previous run. Schedule the Actor (hourly/daily) to get a stream of new posts, releases, videos or episodes. Already-seen items are free. Off = output the current items of every feed on every run.",
            "default": true
          },
          "emitOnBaseline": {
            "title": "Output current items on the first (baseline) run",
            "type": "boolean",
            "description": "Only for monitoring mode. The first run for a feed has nothing to compare to. On = output the current items (up to 'Max items per feed'). Off = silently remember them and output nothing, so you only ever get truly new items (cheapest way to start).",
            "default": true
          },
          "stateKey": {
            "title": "Monitor name (state key)",
            "type": "string",
            "description": "Only for monitoring mode. Monitors with different names keep separate memories (e.g. one per schedule, client or Slack channel). Change it to start a fresh baseline. Leave empty to use the name \"default\"."
          },
          "maxItemsPerFeed": {
            "title": "Max items per feed per run",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Cost cap: at most this many items are output (and charged) per feed per run, newest first. In monitoring mode, new items above the cap are output on the next run (except on the baseline run, which only samples the newest).",
            "default": 50
          },
          "includeKeywords": {
            "title": "Only items mentioning any of these keywords",
            "type": "array",
            "description": "Optional. Case-insensitive; matched against the item title and summary/content. An item is kept if it contains at least one keyword. Filtered items are free.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Skip items mentioning any of these keywords",
            "type": "array",
            "description": "Optional. Case-insensitive; items whose title or summary/content contains any of these are dropped (free).",
            "items": {
              "type": "string"
            }
          },
          "publishedAfter": {
            "title": "Only items published after",
            "type": "string",
            "description": "Optional. A date (2026-11-01, 2026-11-01T08:00:00Z) or a relative time such as '7 days', '24 hours', '2 weeks', '1 month'. Items without a date are kept."
          },
          "includeContent": {
            "title": "Include full content HTML",
            "type": "boolean",
            "description": "Add a contentHtml field with the item's full HTML content as published in the feed (content:encoded, Atom content, JSON content_html). Off keeps the dataset small; a plain-text summary is always included.",
            "default": false
          },
          "useAllDiscoveredFeeds": {
            "title": "Monitor every feed found on a website",
            "type": "boolean",
            "description": "When a web page advertises several feeds (posts, comments, podcast, categories), monitor all of them (max 10 per page). Off = only the main feed (comment feeds are skipped).",
            "default": false
          },
          "discoverOnly": {
            "title": "Feed finder mode (only list the feeds)",
            "type": "boolean",
            "description": "Do not read items. Output one row per working feed found for each URL (feed URL, title, format, item count, date of the latest item). Use it to find the RSS feed of many websites at once.",
            "default": false
          },
          "statusRowWhenEmpty": {
            "title": "Add a status row when there is nothing new",
            "type": "boolean",
            "description": "When a run outputs no items (nothing new since the last run, baseline recorded silently, or no feed readable), add ONE free status row (type 'run-status', not charged) so integrations and dataset checks can tell the run worked. Turn off if your integration should get an empty dataset instead. Real items never have type 'run-status'.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}