{
  "openapi": "3.0.1",
  "info": {
    "title": "RSS Feed Monitor: Only New RSS, Atom & JSON Items",
    "description": "RSS feed monitor: check RSS, Atom and JSON Feed URLs and get only the items that are new since the last run, as clean JSON (RSS to JSON for new items). Handles changing GUIDs, tracking links, bad dates and cross-feed duplicates. For n8n, Make and AI agents.",
    "version": "1.0",
    "x-build-id": "tG1Nr9AfDJWQQkAy2"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/ferrolark~rss-delta/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-ferrolark-rss-delta",
        "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/ferrolark~rss-delta/runs": {
      "post": {
        "operationId": "runs-sync-ferrolark-rss-delta",
        "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/ferrolark~rss-delta/run-sync": {
      "post": {
        "operationId": "run-sync-ferrolark-rss-delta",
        "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": {
          "feedUrls": {
            "title": "Feed URLs",
            "type": "array",
            "description": "Up to 100 RSS 2.0, Atom, RSS 1.0 (RDF) or JSON Feed URLs. If left empty, two demo feeds (Hacker News front page and BBC News) are checked.",
            "items": {
              "type": "string"
            }
          },
          "stateName": {
            "title": "State name",
            "type": "string",
            "description": "Name of the saved state that remembers which items you already received. Use one name per workflow.",
            "default": "default"
          },
          "firstRunItems": {
            "title": "Items per feed on the first run",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "For a feed seen for the first time, emit only the newest N items and mark the rest as seen. 0 = emit nothing on the first run.",
            "default": 5
          },
          "maxNewItemsPerFeed": {
            "title": "Max new items per feed per run",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "If a feed has more new items than this, the newest ones are emitted and the rest are marked as seen.",
            "default": 50
          },
          "dedupeAcrossFeeds": {
            "title": "De-duplicate across feeds",
            "type": "boolean",
            "description": "Skip an item when the same link (ignoring tracking parameters, www and trailing slash) already came from another feed.",
            "default": true
          },
          "dedupeByTitle": {
            "title": "Also de-duplicate by title",
            "type": "boolean",
            "description": "Treat an item with a new GUID and link but the same title as already seen. Off by default because some feeds reuse titles such as \"Release notes\".",
            "default": false
          },
          "summaryMaxChars": {
            "title": "Summary length",
            "minimum": 0,
            "maximum": 2000,
            "type": "integer",
            "description": "Plain-text summary length in characters (HTML removed). 0 = no summary. Full article content is never copied.",
            "default": 300
          },
          "includeAuthors": {
            "title": "Include author names",
            "type": "boolean",
            "description": "Off by default, so no personal names are stored unless you need them.",
            "default": false
          },
          "useStoredState": {
            "title": "Use the stored state",
            "type": "boolean",
            "description": "Read the state saved by previous runs (key-value store \"rss-delta-state\" in your account).",
            "default": true
          },
          "saveState": {
            "title": "Save the state",
            "type": "boolean",
            "description": "Remember this run's items for the next run.",
            "default": true
          },
          "cursor": {
            "title": "Cursor (optional)",
            "type": "object",
            "description": "Advanced: pass the NEXT_CURSOR record from a previous run to manage the state yourself (for example from n8n). When set, it replaces the stored state."
          },
          "returnCursor": {
            "title": "Return the cursor",
            "type": "boolean",
            "description": "Write the next state to the NEXT_CURSOR record of the run's key-value store.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}