{
  "openapi": "3.0.1",
  "info": {
    "title": "Medium Articles Scraper: Tags, Authors, Publications & Claps",
    "description": "Collect Medium articles by tag, author or publication with claps, responses, reading time, word count, language and author data. Go beyond the latest 10 stories, filter by date, claps and keywords, export full text as Markdown, and monitor for new articles on a schedule. No login needed.",
    "version": "0.1",
    "x-build-id": "5JNVdAM8hBe1PQLer"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/getascraper~medium-articles-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-getascraper-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/getascraper~medium-articles-scraper/runs": {
      "post": {
        "operationId": "runs-sync-getascraper-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/getascraper~medium-articles-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-getascraper-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",
            "type": "array",
            "description": "Medium tags to collect stories from, one per row, for example \"machine-learning\" or \"startup\". Every day page Medium lists for the tag is read, so you get far more than the 10 newest stories a feed shows. Spaces and capital letters are fixed for you.",
            "default": [
              "machine-learning"
            ],
            "items": {
              "type": "string"
            }
          },
          "authors": {
            "title": "Authors",
            "type": "array",
            "description": "Medium usernames or profile URLs, one per row, for example \"@dhh\" or \"https://medium.com/@dhh\". Walks the whole publishing history of each author, newest first, not only the latest 10 stories.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "publications": {
            "title": "Publications",
            "type": "array",
            "description": "Publication names from the URL (for example \"better-programming\") or custom domains (for example \"netflixtechblog.com\"), one per row. Walks the full story list of each publication, newest first.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "articleUrls": {
            "title": "Article URLs",
            "type": "array",
            "description": "Direct links to individual Medium stories. Each one is read in full, including claps, responses, reading time, author and publication details.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Start URLs",
            "type": "array",
            "description": "Paste any Medium link and the type is detected for you: a tag page, an author profile, a publication, an article, or a feed URL. A feed URL is read like a feed reader would, which returns about the 10 newest stories.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "dateFrom": {
            "title": "Published from",
            "type": "string",
            "description": "Only keep articles published on or after this date. Use a calendar date or a relative value such as \"7 days\". For tags this also limits how many day pages are read."
          },
          "dateTo": {
            "title": "Published until",
            "type": "string",
            "description": "Only keep articles published on or before this date. Leave empty for \"up to now\"."
          },
          "minClaps": {
            "title": "Minimum claps",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Skip articles with fewer claps than this. Claps are Medium's like count and the best quick signal of how well a story performed. 0 keeps everything.",
            "default": 0
          },
          "minResponses": {
            "title": "Minimum responses",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Skip articles with fewer reader responses (comments) than this. 0 keeps everything.",
            "default": 0
          },
          "minReadingTimeMinutes": {
            "title": "Minimum reading time",
            "minimum": 0,
            "maximum": 600,
            "type": "integer",
            "description": "Skip short reads. Useful to drop quick notes and keep in-depth articles. 0 keeps everything.",
            "default": 0
          },
          "maxReadingTimeMinutes": {
            "title": "Maximum reading time",
            "minimum": 0,
            "maximum": 600,
            "type": "integer",
            "description": "Skip long reads. 0 means no upper limit on reading time.",
            "default": 0
          },
          "minWordCount": {
            "title": "Minimum word count",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Skip articles shorter than this many words. 0 keeps everything.",
            "default": 0
          },
          "paywall": {
            "title": "Member-only stories",
            "enum": [
              "all",
              "freeOnly",
              "memberOnly"
            ],
            "type": "string",
            "description": "Medium marks some stories as member-only. Choose whether to keep everything, only freely readable stories, or only member-only ones. Member-only stories are never unlocked: with full text on you receive the public preview and it is flagged as a preview.",
            "default": "all"
          },
          "languages": {
            "title": "Languages",
            "type": "array",
            "description": "Keep only articles detected in these language codes, for example \"en\" or \"es\". Leave empty for every language.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeKeywords": {
            "title": "Must mention any keyword",
            "type": "array",
            "description": "Keep only articles whose title, subtitle, excerpt or tags contain at least one of these words or phrases (case-insensitive). With full text switched on the article body is searched too.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Must not mention keyword",
            "type": "array",
            "description": "Drop articles whose title, subtitle, excerpt or tags contain any of these words or phrases (case-insensitive).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "requiredTags": {
            "title": "Must also carry tags",
            "type": "array",
            "description": "Keep only articles that carry all of these tags, for example scan the \"machine-learning\" tag but require \"python\" as well.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "onlyPublications": {
            "title": "Only from publications",
            "type": "array",
            "description": "Keep only articles published in one of these publications (name from the URL or custom domain). Handy when scanning a broad tag for a few outlets.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "onlyAuthors": {
            "title": "Only from authors",
            "type": "array",
            "description": "Keep only articles written by one of these usernames. Handy when scanning a broad tag for known writers.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "excludeResponses": {
            "title": "Skip responses",
            "type": "boolean",
            "description": "Medium stores reader responses (comments) as small stories of their own. Leave this on to receive real articles only.",
            "default": true
          },
          "includeContent": {
            "title": "Include full article text",
            "type": "boolean",
            "description": "Opens every article to add the complete body in the chosen format, plus exact claps and responses. Slower than listing only, because each article is one extra page read.",
            "default": false
          },
          "contentFormat": {
            "title": "Text format",
            "enum": [
              "markdown",
              "text",
              "html"
            ],
            "type": "string",
            "description": "Format of the article body when full text is switched on. Markdown keeps headings, lists, links and code blocks, which suits AI datasets and LLM pipelines.",
            "default": "markdown"
          },
          "includeLinksAndImages": {
            "title": "Include links and images",
            "type": "boolean",
            "description": "Adds the list of outbound links and image URLs found in each article body. Opens every article, like the full text option.",
            "default": false
          },
          "includeAuthorDetails": {
            "title": "Include author follower counts",
            "type": "boolean",
            "description": "Looks up each distinct author once and adds their follower count and bio. Author sources and full-text runs already include it.",
            "default": false
          },
          "onlyNewArticles": {
            "title": "Only articles not delivered before",
            "type": "boolean",
            "description": "Monitor mode for schedules: remembers the articles earlier runs delivered and returns only new ones, so a daily schedule on a tag gives a clean feed of fresh stories. Tag scans also stop at the previous run date.",
            "default": false
          },
          "monitorScope": {
            "title": "Monitor name",
            "type": "string",
            "description": "Name of the memory used by monitor mode. Use one name per schedule, so two monitors with different tags do not share what they have already delivered.",
            "default": "default"
          },
          "maxItems": {
            "title": "Maximum articles",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Total number of articles to return across all sources. Raise it for bigger exports.",
            "default": 10
          },
          "maxItemsPerSource": {
            "title": "Maximum articles per source",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Optional cap for each tag, author or publication. Leave empty to split the total evenly between your sources."
          },
          "sortBy": {
            "title": "Order",
            "enum": [
              "newest",
              "mostClaps",
              "mostResponses"
            ],
            "type": "string",
            "description": "Newest first returns rows as soon as they are found. The other two read the full scan window of each source first, then return the best articles.",
            "default": "newest"
          },
          "maxDaysToScan": {
            "title": "Max days to scan per tag",
            "minimum": 1,
            "maximum": 366,
            "type": "integer",
            "description": "A tag is read one calendar day at a time, newest day first. This caps how many day pages are read per tag, so a run stays bounded. Raise it for long date ranges.",
            "default": 14
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 8,
            "type": "integer",
            "description": "How many pages are read at the same time. Higher is faster but more likely to be slowed down by Medium.",
            "default": 3
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify Proxy datacenter IPs work for this target, no residential proxy is needed.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}