{ "openapi": "3.0.1", "info": { "title": "Medium Articles Scraper & Monitor (RSS, Markdown)", "description": "Get Medium articles by tag, author, publication, or any Medium URL. Full text as clean Markdown, keyword and date filters, and an 'only new articles' mode for scheduled monitoring.", "version": "0.1", "x-build-id": "FbcMugGf8t8H2ufMg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dima_kadirovich~medium-articles-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dima_kadirovich-medium-articles-scraper", "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/dima_kadirovich~medium-articles-scraper/runs": { "post": { "operationId": "runs-sync-dima_kadirovich-medium-articles-scraper", "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/dima_kadirovich~medium-articles-scraper/run-sync": { "post": { "operationId": "run-sync-dima_kadirovich-medium-articles-scraper", "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": { "tags": { "title": "Tags / topics", "type": "array", "description": "Medium topics, for example `artificial-intelligence`, `kubernetes`, `startup`. Spaces are fine (`machine learning`). Tag feeds give a short excerpt of each article; use authors or publications for full text.", "items": { "type": "string" } }, "users": { "title": "Authors", "type": "array", "description": "Medium usernames (`@dhh` or `dhh`) or profile links (`https://medium.com/@dhh`, `https://someone.medium.com`). Returns full article text.", "items": { "type": "string" } }, "publications": { "title": "Publications", "type": "array", "description": "Publication slugs (`better-programming`) or domains/links (`netflixtechblog.com`). Returns full article text.", "items": { "type": "string" } }, "urls": { "title": "Any Medium links", "type": "array", "description": "Paste any Medium link and the Actor detects whether it is a tag, author, publication, or custom-domain blog.", "items": { "type": "string" } }, "keywords": { "title": "Keywords filter", "type": "array", "description": "Keep only articles whose title, tags, or text contain at least one of these words (case-insensitive). Leave empty to keep everything.", "items": { "type": "string" } }, "publishedWithinDays": { "title": "Published in the last N days", "minimum": 1, "type": "integer", "description": "Keep only articles published within this many days. Leave empty for no date limit." }, "onlyNew": { "title": "Only new articles (monitoring mode)", "type": "boolean", "description": "Remember which articles earlier runs already returned and skip them. Turn this on when you schedule the Actor (for example every hour), so each run gives you only fresh articles and you only pay for new ones.", "default": false }, "maxItems": { "title": "Max articles", "minimum": 1, "type": "integer", "description": "Upper limit on articles saved in one run.", "default": 1000 }, "includeHtml": { "title": "Include original HTML", "type": "boolean", "description": "Also save the original article HTML next to the Markdown.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed in most cases. Enable only if Medium starts rate-limiting your runs.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }