{
  "openapi": "3.0.1",
  "info": {
    "title": "Gulf Business News Monitor (Arabic & English)",
    "description": "Track Saudi, UAE, and GCC business news from publisher RSS feeds in Arabic and English. Get only new stories matching your companies and keywords, with duplicate coverage merged across outlets.",
    "version": "0.1",
    "x-build-id": "vx2Pn5439edKmzbqF"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/pharaoh_data~gulf-business-news-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-pharaoh_data-gulf-business-news-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/pharaoh_data~gulf-business-news-monitor/runs": {
      "post": {
        "operationId": "runs-sync-pharaoh_data-gulf-business-news-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/pharaoh_data~gulf-business-news-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-pharaoh_data-gulf-business-news-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": {
          "presets": {
            "title": "Publisher feeds",
            "type": "array",
            "description": "Verified public RSS feeds from Gulf and regional publishers. The list is checked for availability and robots.txt permission; feeds can change, and failures are reported per feed in RUN_SUMMARY.",
            "items": {
              "type": "string",
              "enum": [
                "saudi-gazette",
                "gulf-news",
                "khaleej-times",
                "the-national",
                "the-national-business",
                "asharq-al-awsat-en",
                "asharq-al-awsat-ar",
                "sky-news-arabia",
                "bbc-arabic",
                "wamda",
                "news-of-bahrain",
                "oman-observer",
                "fast-company-me"
              ],
              "enumTitles": [
                "Saudi Gazette (Saudi Arabia, English)",
                "Gulf News (UAE, English)",
                "Khaleej Times (UAE, English)",
                "The National – all news (UAE, English)",
                "The National – business (UAE, English)",
                "Asharq Al-Awsat (regional, English)",
                "الشرق الأوسط (regional, Arabic)",
                "سكاي نيوز عربية (UAE, Arabic)",
                "BBC عربي (international, Arabic)",
                "Wamda – MENA startups (English)",
                "News of Bahrain (Bahrain, English)",
                "Oman Observer (Oman, English)",
                "Fast Company Middle East (English)"
              ]
            },
            "default": [
              "saudi-gazette",
              "gulf-news",
              "khaleej-times",
              "the-national-business",
              "asharq-al-awsat-ar",
              "sky-news-arabia"
            ]
          },
          "feedUrls": {
            "title": "Additional RSS or Atom feeds",
            "type": "array",
            "description": "Any other public RSS or Atom feed URLs, such as a company newsroom, a regulator, or a trade publication. Only add feeds you are permitted to use. robots.txt is always respected.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "keywords": {
            "title": "Keywords and company names",
            "type": "array",
            "description": "Keep stories whose headline or summary contains any of these, as whole words. Arabic and English are supported; Arabic matching ignores diacritics, spelling variants, and attached prefixes such as و، ب، ال. End a term with * for a prefix match (bank* matches banking). Leave empty to keep every story.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "excludeKeywords": {
            "title": "Exclude keywords",
            "type": "array",
            "description": "Drop stories that contain any of these terms, for example football or كرة القدم.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Keep stories that mention one of these countries (English or Arabic place names), or that come from a publisher based there. Leave empty for no country filter.",
            "items": {
              "type": "string",
              "enum": [
                "SA",
                "AE",
                "QA",
                "KW",
                "BH",
                "OM"
              ],
              "enumTitles": [
                "Saudi Arabia",
                "United Arab Emirates",
                "Qatar",
                "Kuwait",
                "Bahrain",
                "Oman"
              ]
            },
            "default": []
          },
          "languages": {
            "title": "Languages",
            "type": "array",
            "description": "Keep stories in these languages, detected from the headline. Leave empty for both.",
            "items": {
              "type": "string",
              "enum": [
                "en",
                "ar"
              ],
              "enumTitles": [
                "English",
                "Arabic"
              ]
            },
            "default": []
          },
          "maxAgeHours": {
            "title": "Maximum story age (hours)",
            "minimum": 0,
            "maximum": 2160,
            "type": "integer",
            "description": "Ignore stories published longer ago than this. 0 keeps every story in the feed. Stories without a date are kept.",
            "default": 48
          },
          "onlyNew": {
            "title": "Only new stories",
            "type": "boolean",
            "description": "Return only stories this monitor has not returned in an earlier run, for scheduled alerts. When off, every matching story is returned each run, with isNew showing which are new.",
            "default": false
          },
          "monitorId": {
            "title": "Monitor ID",
            "type": "string",
            "description": "Optional name for this monitor's history, such as \"aramco-watch\". When empty, an ID is derived from the feeds and filters. History is kept for 30 days in your account's named key-value store gulf-news-monitor-state.",
            "default": ""
          },
          "maxItems": {
            "title": "Maximum stories per run",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Upper limit on saved stories, newest first. Each saved story is one billable result.",
            "default": 300
          },
          "maxItemsPerFeed": {
            "title": "Maximum items read per feed",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Items read from each feed before filtering.",
            "default": 100
          },
          "includeSummary": {
            "title": "Include feed summaries",
            "type": "boolean",
            "description": "Include the summary the publisher puts in its feed (up to 500 characters). Full article text is never collected.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}