{ "openapi": "3.0.1", "info": { "title": "News & Brand Mention Monitor (RSS & Atom Feeds)", "description": "Find every news mention of your brand, competitors, or keywords in the publisher RSS and Atom feeds you choose. Deduplicated by link and title. Monitor mode delivers only mentions you have not seen before, for PR, SEO, and market alerts.", "version": "0.1", "x-build-id": "9RKs9JloIqQEc41hZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maniginam~news-brand-mention-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maniginam-news-brand-mention-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/maniginam~news-brand-mention-monitor/runs": { "post": { "operationId": "runs-sync-maniginam-news-brand-mention-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/maniginam~news-brand-mention-monitor/run-sync": { "post": { "operationId": "run-sync-maniginam-news-brand-mention-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", "required": [ "queries", "feeds" ], "properties": { "onlyNewMentions": { "title": "Only new mentions (monitor mode)", "type": "boolean", "description": "When on, the Actor remembers every mention it delivered for these queries, and outputs only mentions it has not delivered before. A story counts as seen when its link (with tracking parameters removed) or its title at the same publisher was delivered before. Mentions already seen are skipped and not charged. The first run delivers every mention as new. Use it with a daily or hourly schedule for alerts.", "default": false }, "queries": { "title": "Search queries", "minItems": 1, "maxItems": 100, "type": "array", "description": "One query per line: a brand such as OpenAI, a phrase in quotes such as \"web scraping\", alternatives joined by OR, and words to leave out with a minus such as -jobs. A feed entry is kept when its title or summary mentions one of the queries.", "items": { "type": "string", "maxLength": 200 } }, "feeds": { "title": "Publisher RSS or Atom feeds", "minItems": 1, "maxItems": 200, "type": "array", "description": "Publisher feed links to read, such as https://techcrunch.com/feed/ or https://www.theverge.com/rss/index.xml. Add at least one. Most news sites and blogs publish one, often at /feed or /rss. Only entries that mention one of the queries are kept.", "items": { "type": "string", "maxLength": 2000 } }, "maxAgeDays": { "title": "Maximum age in days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only mentions published in this many days are kept. Mentions without a date are kept.", "default": 7 }, "excludeKeywords": { "title": "Exclude keywords", "maxItems": 50, "type": "array", "description": "Drop mentions whose title or summary contains any of these words or phrases, for example jobs or press release.", "items": { "type": "string", "maxLength": 100 } }, "maxResults": { "title": "Maximum mention records", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The run stops once this many mention records are delivered. Mentions left over are not remembered, so a monitor delivers them next time. The form starts at 20 so a first run is quick.", "default": 1000 } } }, "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 } } } } } } } } } }