{ "openapi": "3.0.1", "info": { "title": "Media Mention Monitor for Brand Coverage", "description": "Monitor a brand or competitor watchlist in Google News RSS and trusted public feeds. Returns deduplicated mentions with query, publisher, source URL, dates, and collection-time provenance. Use for bounded press-coverage review, not social listening or PR outreach. $0.01/mention plus $0.00005 start.", "version": "0.1", "x-build-id": "C8OUjUYOuHAZCWtME" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~meltwater-alternative/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-meltwater-alternative", "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/khadinakbar~meltwater-alternative/runs": { "post": { "operationId": "runs-sync-khadinakbar-meltwater-alternative", "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/khadinakbar~meltwater-alternative/run-sync": { "post": { "operationId": "run-sync-khadinakbar-meltwater-alternative", "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": [ "watchQueries" ], "properties": { "watchQueries": { "title": "Brands, competitors, or topics to monitor", "minItems": 1, "maxItems": 10, "type": "array", "description": "One to ten literal news-search queries, such as OpenAI, \"Acme Corp\", or \"Acme Corp\" AND security. Each query is sent to Google News RSS and retained rows record the query that produced them. Use plain news-search syntax only; this is not a social-network handle list or a request for sentiment analysis.", "items": { "type": "string" } }, "trustedSources": { "title": "Trusted public RSS, Atom, or JSON feeds", "maxItems": 50, "type": "array", "description": "Optional public feeds or publisher homepages to include alongside Google News, for example https://hnrss.org/frontpage. Homepage URLs are inspected only for an advertised public feed. Add tags to retain source provenance. This does not access paywalled, private, authenticated, or local-network sources.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "title": "Feed or website URL", "type": "string", "description": "Public HTTP(S) feed URL or publisher homepage, for example https://hnrss.org/frontpage. The actor discovers only an advertised public feed from a homepage. Do not provide a credentialed, private, or local-network URL." }, "name": { "title": "Source name", "type": "string", "description": "Optional short source label, for example Hacker News. It is copied to retained mentions from this source. This does not change the remote publisher name." }, "tags": { "title": "Source tags", "type": "array", "items": { "type": "string" }, "maxItems": 20, "description": "Optional grouping labels, such as technology or trade-press. They are copied to output records and do not filter a source." } } }, "default": [] }, "language": { "title": "Google News language", "enum": [ "en-US", "en-GB", "de", "fr", "es", "pt-BR", "ja" ], "type": "string", "description": "Language used for Google News RSS results. Defaults to English (United States). This controls the Google News request locale, not translation or source language classification.", "default": "en-US" }, "country": { "title": "Google News country", "enum": [ "US", "GB", "CA", "AU", "DE", "FR", "ES", "BR", "JP" ], "type": "string", "description": "Country edition used for Google News RSS. Defaults to the United States. It scopes the Google News edition but does not guarantee an article publisher or audience is located there.", "default": "US" }, "lookbackDays": { "title": "News lookback window in days", "minimum": 1, "maximum": 30, "type": "integer", "description": "Optional Google News search window from 1 to 30 days, for example 7 for weekly coverage review. Trusted feeds are filtered by their supplied publication dates when present. This is a collection window, not a recurring schedule.", "default": 7 }, "maxItems": { "title": "Maximum mentions to return", "minimum": 1, "maximum": 500, "type": "integer", "description": "Whole-run maximum number of normalized mentions persisted, from 1 to 500. The actor stops before this cap, so the $0.01 per-mention event charge cannot exceed it. This is not a per-query or per-source limit.", "default": 100 }, "excludeKeywords": { "title": "Keywords to exclude", "type": "array", "description": "Optional case-insensitive terms that remove matching headlines, snippets, or feed text, such as sponsored. Leave empty to retain all otherwise eligible mentions. These are literal contains checks, not Boolean query syntax or regular expressions.", "items": { "type": "string" }, "default": [] } } }, "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 } } }, "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 } } } } } } } } } }