{ "openapi": "3.0.1", "info": { "title": "Medium Articles Scraper", "description": "Collect public Medium articles by keyword, tag, author, publication, or article URL. Get titles, authors, dates, tags, previews, engagement counts, access status, and optional full text in structured dataset rows.", "version": "0.0", "x-build-id": "stDWfG8lIJW12h6JZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~medium-articles/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-medium-articles", "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/maximedupre~medium-articles/runs": { "post": { "operationId": "runs-sync-maximedupre-medium-articles", "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/maximedupre~medium-articles/run-sync": { "post": { "operationId": "run-sync-maximedupre-medium-articles", "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": [ "target" ], "properties": { "target": { "title": "Target", "enum": [ "keyword", "tag", "author", "publication", "articleUrl" ], "type": "string", "description": "Choose what to find in this run." }, "keywords": { "title": "Keywords", "minItems": 1, "type": "array", "description": "For Keyword search, enter one or more words or phrases. Add each one as a separate item.", "items": { "type": "string", "minLength": 1 }, "default": [ "programming" ] }, "tag": { "title": "Tag or topic", "minLength": 1, "type": "string", "description": "For Tag or topic, enter one public Medium tag, such as `programming`." }, "authorUrl": { "title": "Author profile URL", "minLength": 1, "type": "string", "description": "For Author profile, enter one public Medium author profile URL, such as `https://medium.com/@username`." }, "publicationUrl": { "title": "Publication URL", "minLength": 1, "type": "string", "description": "For Publication, enter one public Medium publication URL, such as `https://medium.com/publication-name`." }, "articleUrl": { "title": "Article URL", "minLength": 1, "type": "string", "description": "For Article URL, enter one public Medium article URL, such as `https://medium.com/@author/article-title-1234567890`." }, "includeFullText": { "title": "Include full text", "type": "boolean", "description": "Also get public full text when it is available. This does not bypass member-only access.", "default": false }, "includeMemberOnly": { "title": "Include member-only articles", "type": "boolean", "description": "Keep member-only articles in the metadata results. Set this to false to remove them.", "default": true }, "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many article records. Leave it empty to return all available results until the source is exhausted.", "default": 1 }, "publishedAfter": { "title": "Published after", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "For Keyword search, Tag or topic, Author profile, and Publication targets, include articles published on or after this UTC date. Article URL ignores this field." }, "publishedBefore": { "title": "Published before", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "For Keyword search, Tag or topic, Author profile, and Publication targets, include articles published on or before this UTC date. Article URL ignores this field." }, "previewKeyword": { "title": "Preview keyword", "minLength": 1, "type": "string", "description": "After discovery, keep articles with this word or phrase in the title or public preview. Article URL ignores this field." } } }, "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 } } } } } } } } } }