{
  "openapi": "3.0.1",
  "info": {
    "title": "News & RSS Monitor: Keyword Alerts, Only New Articles",
    "description": "Monitor news and RSS feeds for your keywords and get only new articles on every run. Built-in MENA and AI-lab source packs, Arabic-aware matching.",
    "version": "0.0",
    "x-build-id": "lFgAmQot5Pf8ldAuG"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scraper_guru~news-rss-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scraper_guru-news-rss-monitor",
        "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/scraper_guru~news-rss-monitor/runs": {
      "post": {
        "operationId": "runs-sync-scraper_guru-news-rss-monitor",
        "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/scraper_guru~news-rss-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-scraper_guru-news-rss-monitor",
        "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": {
          "packs": {
            "title": "Source packs",
            "type": "array",
            "description": "Built-in, checked news feeds. MENA news: 10 outlets from Morocco, Algeria, the UAE, Jordan and pan-Arab media. AI labs: Hugging Face, Google DeepMind, Google AI, Mistral AI. AI research: new arXiv cs.AI papers (about 800 a day, so many articles per run).",
            "items": {
              "type": "string",
              "enum": [
                "mena",
                "ai",
                "research"
              ],
              "enumTitles": [
                "MENA news",
                "AI labs",
                "AI research (arXiv, ~800 papers a day)"
              ]
            }
          },
          "countries": {
            "title": "Countries (MENA pack)",
            "type": "array",
            "description": "Only MENA pack outlets from these countries. Leave empty for all. \"Pan-Arab\" = Asharq Al-Awsat and Sky News Arabia.",
            "items": {
              "type": "string",
              "enum": [
                "MA",
                "DZ",
                "AE",
                "JO",
                "MENA"
              ],
              "enumTitles": [
                "Morocco",
                "Algeria",
                "United Arab Emirates",
                "Jordan",
                "Pan-Arab"
              ]
            }
          },
          "languages": {
            "title": "Languages (packs)",
            "type": "array",
            "description": "Only pack feeds in these languages. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "ar",
                "fr",
                "en"
              ],
              "enumTitles": [
                "Arabic",
                "French",
                "English"
              ]
            }
          },
          "sources": {
            "title": "Your own feeds",
            "type": "array",
            "description": "RSS or Atom feed URLs to watch, one per line. Optional when you pick a pack. You are responsible for the sources you add.",
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Return articles whose title or summary mention any of these. Arabic spellings and prefixes match (أرامكو = الأرامكو = ارامكو); other languages match whole words; put \"quotes\" around a phrase. Leave empty to get every new article.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Exclude words",
            "type": "array",
            "description": "Drop an article if it mentions any of these, even when a keyword matches.",
            "items": {
              "type": "string"
            }
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Each monitor remembers which articles it already returned, so scheduled runs give only new ones. Use one name per topic or client (letters, digits, dots, hyphens, underscores). Changing keywords or feeds keeps the memory.",
            "default": "default"
          },
          "onlyNew": {
            "title": "Only new articles",
            "type": "boolean",
            "description": "Return only articles this monitor has not returned before. Turn off to get everything currently in the feeds (memory is not read or changed).",
            "default": true
          },
          "firstRunDays": {
            "title": "First run: last N days",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "On a monitor's first run, return only articles published in the last N days. Older ones are remembered and skipped.",
            "default": 7
          },
          "resetMonitor": {
            "title": "Reset this monitor's memory",
            "type": "boolean",
            "description": "Forget everything this monitor returned and start again (the first-run window applies).",
            "default": false
          },
          "maxFeeds": {
            "title": "Max feeds per run",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Protects against huge lists.",
            "default": 500
          },
          "maxArticles": {
            "title": "Max articles per run",
            "minimum": 1,
            "type": "integer",
            "description": "Caps your spend per run. Empty = no cap."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}