{ "openapi": "3.0.1", "info": { "title": "News Brand Mentions Monitor: New Articles Only", "description": "Track your brand, competitors, executives or any topic in the news. Searches Google News and GDELT, removes duplicates, resolves the publisher URL and returns only articles that are new since your last run. Ready for a daily Slack or e-mail digest.", "version": "1.0", "x-build-id": "sD5uPuiI3o4ssow9N" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/offerastudio~news-brand-mentions-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-offerastudio-news-brand-mentions-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/offerastudio~news-brand-mentions-monitor/runs": { "post": { "operationId": "runs-sync-offerastudio-news-brand-mentions-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/offerastudio~news-brand-mentions-monitor/run-sync": { "post": { "operationId": "run-sync-offerastudio-news-brand-mentions-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" ], "properties": { "queries": { "title": "Queries", "type": "array", "description": "What to look for, one query per line. Use \"exact phrases\" in quotes, OR between alternatives and a minus sign to exclude a word, e.g. \"Acme Corp\" OR AcmeCorp -jobs. Up to 50 queries.", "items": { "type": "string" } }, "languages": { "title": "Languages", "type": "array", "description": "Two-letter language codes, e.g. en, de, fr, es. Default: en. Google News is searched for every language and country pair (at most 6 pairs).", "default": [ "en" ], "items": { "type": "string" } }, "countries": { "title": "Countries (Google News edition)", "type": "array", "description": "Two-letter country codes of the Google News edition, e.g. US, GB, DE. Default: US.", "default": [ "US" ], "items": { "type": "string" } }, "sinceHours": { "title": "Articles from the last (hours)", "minimum": 1, "maximum": 720, "type": "integer", "description": "Only articles published within this many hours. Default 48, maximum 720 (30 days).", "default": 48 }, "sources": { "title": "Sources", "enum": [ "both", "google-news", "gdelt" ], "type": "string", "description": "Google News RSS gives the most relevant headlines; GDELT adds wider worldwide coverage. Default: both.", "default": "both" }, "mode": { "title": "Mode", "enum": [ "all", "monitor" ], "type": "string", "description": "All: return every article found. Monitor: return only articles not returned in an earlier run with the same monitor name (the first run returns everything).", "default": "all" }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Names this watch (monitor mode). Runs with the same name share one memory of returned articles, kept in a named key-value store. Default: derived from your queries." }, "maxResults": { "title": "Maximum articles", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stops after this many articles. Default 200, maximum 5,000.", "default": 200 }, "resolvePublisherUrls": { "title": "Resolve publisher URLs", "type": "boolean", "description": "Google News links point to a Google redirect page. When on, the Actor looks up the real publisher URL for each returned Google article (two polite requests per article, at most 300 per run). Articles that cannot be resolved keep the Google link and urlResolved=false.", "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 } } } } } } } } } }