{ "openapi": "3.0.1", "info": { "title": "Media Monitoring API - Mentions, Sentiment, Reach, Determ", "description": "Export media monitoring mentions from your own Determ (Mediatoolkit) account: web, news, social, forums, print, TV and radio, with sentiment, reach, virality, interactions and influence score, plus mention counts by source type and your groups and keywords. Read only. Bring your own token.", "version": "0.1", "x-build-id": "O1arE6gw07vS4TTIM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabeelbaghoor~media-monitoring-mentions-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabeelbaghoor-media-monitoring-mentions-api", "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/nabeelbaghoor~media-monitoring-mentions-api/runs": { "post": { "operationId": "runs-sync-nabeelbaghoor-media-monitoring-mentions-api", "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/nabeelbaghoor~media-monitoring-mentions-api/run-sync": { "post": { "operationId": "run-sync-nabeelbaghoor-media-monitoring-mentions-api", "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": { "mode": { "title": "What to read", "enum": [ "organizations", "mentions", "counts", "account" ], "type": "string", "description": "Organizations lists every organization your token reaches with its groups, keywords and tags, and needs nothing else, so it is the default: it gives the IDs the other modes use. Mentions pages through the mentions of one keyword or one group. Mention counts returns the total and the count per source type for one keyword or group. Account shows the user behind the token.", "default": "organizations" }, "organizationId": { "title": "Organization ID", "type": "string", "description": "The numeric Determ organization ID, as the organizations or account mode lists it. Optional: when the token reaches only one organization it is used automatically. In the organizations mode it limits the listing to that one." }, "keywordId": { "title": "Keyword ID", "type": "string", "description": "Mentions and mention counts. The numeric ID of one keyword (monitoring query), as the organizations mode lists it. Set this or a group ID, not both." }, "groupId": { "title": "Group ID", "type": "string", "description": "Mentions and mention counts. The numeric ID of one group, which reads all of its keywords together. Set this or a keyword ID, not both." }, "timeRange": { "title": "Time range", "enum": [ "TODAY", "YESTERDAY", "LAST_24_HOURS", "LAST_7_DAYS", "LAST_30_DAYS", "LAST_90_DAYS", "THIS_MONTH", "THIS_WEEK", "LAST_WEEK", "LAST_MONTH", "CUSTOM", "ALL" ], "type": "string", "description": "Mentions and mention counts. A preset period, resolved in the organization time zone, or Custom to use the date start and end below. Setting a date start or end always uses the custom range.", "default": "LAST_30_DAYS" }, "timeField": { "title": "Time range applies to", "enum": [ "published", "feed" ], "type": "string", "description": "Mentions and mention counts. Filter on when the mention was published, or on when it entered your feed (use this for incremental exports).", "default": "published" }, "dateFrom": { "title": "Date start", "type": "string", "description": "Custom range start, inclusive, as YYYY-MM-DD or an ISO 8601 date-time such as 2026-09-01T00:00:00Z." }, "dateTo": { "title": "Date end", "type": "string", "description": "Custom range end, exclusive, as an ISO 8601 date-time. A plain YYYY-MM-DD date includes that whole day." }, "sourceTypes": { "title": "Source types", "type": "array", "description": "Mentions and mention counts. Keep only mentions from these source types. Leave empty for all.", "items": { "type": "string", "enum": [ "WEB", "FACEBOOK", "TWITTER", "FORUM", "COMMENT", "YOUTUBE", "INSTAGRAM", "REDDIT", "TIKTOK", "PRINT", "RADIO", "TV", "BLUESKY" ], "enumTitles": [ "Web and news", "Facebook", "X (Twitter)", "Forums", "Comments", "YouTube", "Instagram", "Reddit", "TikTok", "Print", "Radio", "TV", "Bluesky" ] } }, "excludeSourceTypes": { "title": "Exclude source types", "type": "array", "description": "Mentions and mention counts. Leave out mentions from these source types.", "items": { "type": "string", "enum": [ "WEB", "FACEBOOK", "TWITTER", "FORUM", "COMMENT", "YOUTUBE", "INSTAGRAM", "REDDIT", "TIKTOK", "PRINT", "RADIO", "TV", "BLUESKY" ], "enumTitles": [ "Web and news", "Facebook", "X (Twitter)", "Forums", "Comments", "YouTube", "Instagram", "Reddit", "TikTok", "Print", "Radio", "TV", "Bluesky" ] } }, "sentiments": { "title": "Sentiments", "type": "array", "description": "Mentions and mention counts. Keep only mentions with these sentiments. Leave empty for all.", "items": { "type": "string", "enum": [ "POSITIVE", "NEUTRAL", "NEGATIVE", "UNDEFINED" ], "enumTitles": [ "Positive", "Neutral", "Negative", "Undefined" ] } }, "excludeSentiments": { "title": "Exclude sentiments", "type": "array", "description": "Mentions and mention counts. Leave out mentions with these sentiments.", "items": { "type": "string", "enum": [ "POSITIVE", "NEUTRAL", "NEGATIVE", "UNDEFINED" ], "enumTitles": [ "Positive", "Neutral", "Negative", "Undefined" ] } }, "sortBy": { "title": "Sort mentions by", "enum": [ "PUBLISHED_TIME", "FEED_TIME", "REACH", "VIRALITY", "INTERACTIONS", "INFLUENCE", "ENGAGEMENT" ], "type": "string", "description": "Mentions. The documented sort fields.", "default": "PUBLISHED_TIME" }, "sortDirection": { "title": "Sort direction", "enum": [ "DESC", "ASC" ], "type": "string", "description": "Mentions. Descending (newest or highest first) or ascending.", "default": "DESC" }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most rows this run returns and charges for. Mentions are read up to 1,000 a page with a scroll token, so large exports are supported.", "default": 100 }, "requestsPerMinute": { "title": "Requests per minute", "minimum": 1, "maximum": 100, "type": "integer", "description": "Pacing. The provider allows 100 mention scroll or count calls a minute per user, shared by the keyword and group routes.", "default": 60 }, "apiKey": { "title": "API token", "type": "string", "description": "Your own Determ API token, from Settings > Account Settings in the Determ app (shown on plans that include API access). Stored as a secret. You can instead set the DATA_API_KEY environment secret." } } }, "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 } } } } } } } } } }