Playground Sign in Start free
News and finance · medium.com

How to scrape Medium

Medium (medium.com) is a news and finance site. Our checks of its public pages are failing at the moment. This guide shows what we see, what we tried, and the settings to use once it works again.

Currently blocked

0 of 19 of our checks passed in the last 7 days (0%). Currently blocked: we are working on it, and this page changes as soon as a check passes again.

Last check 2026-10-13 16:06 UTC · last pass never · checked with our own requests, never customer data.

Try it in the Playground

Run the code on this page with your own key: 5,000 free credits for 7 days, no card. Get a free API key →

What you can get

The API returns the rendered HTML of the page. Select the fields you need with extract rules (CSS selectors) or parse the HTML on your side.

Public pages Currently blocked

Page types we check: Public pages, Detail pages.

The pages carry JSON-LD structured data of type NewsArticle, Article.

Code

Complete scripts: set the UJEEBU_API_KEY environment variable and run them as they are. Each one sends the settings on this page, prints the start of the page, and prints the credits the request cost (the Ujb-Credits response header) on stderr. A non-200 answer stops the script with the API's error message.

medium_page_sdk.py pip install ujeebu-python==0.1.5
# Fetch a Medium page with the Ujeebu Scrape API.
# Settings from our health checks (Ujeebu site guide). Prints the start of the page HTML.
# Uses the official SDK ujeebu-python 0.1.5: pip install ujeebu-python==0.1.5
# Run: UJEEBU_API_KEY=your_key python3 medium_page_sdk.py

import json
import os
import sys
import time

import requests
from ujeebu_python import UjeebuClient

API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
    "https://medium.com/tag/programming",
]
SETTINGS = {
    "js": True,
}


def scrape(client, url):
    try:
        response = client.scrape(url, params=SETTINGS)
    except requests.RequestException as error:
        sys.exit(f"Request failed for {url}: {error}")
    if response.status_code != 200:
        try:
            message = response.json().get("message", response.text)
        except ValueError:
            message = response.text
        sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
    print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}", file=sys.stderr)
    return response.text


if not API_KEY:
    sys.exit("Set the UJEEBU_API_KEY environment variable.")

client = UjeebuClient(api_key=API_KEY)

for i, url in enumerate(URLS):
    if i:
        time.sleep(2)  # be polite: one page at a time
    html = scrape(client, url)
    print(len(html), "bytes")
    print(html[:500])

SDK tabs use the official Ujeebu SDKs (ujeebu-python 0.1.5, @ujeebu-org/ujeebu-sdk 0.1.2, github.com/ujeebu/ujeebu-go v0.1.8); there is no PHP SDK, so the PHP tab calls the API with curl. For agents and scripts, the same status and settings are at /scrape/medium.json.

Try it yourself

Run this on Medium with your own key

Get a free API key, set UJEEBU_API_KEY and run any script above as it is. 5,000 free credits for 7 days, no card.

Settings that work today

From our health checks over the last 7 days: the cheapest settings that return the real page most of the time.

Endpoint/scrape
jstrue
Costup to 5 credits a request (only HTTP 200 and 404 are billed)

No proxy passed in the last 7 days: these are the settings we keep trying.

Each public page is one request: change the path in the URL to fetch another one. Collect detail page URLs from listing pages first, then fetch each detail page. Our checks run with JavaScript rendering on (js=true): keep it on. Requests are failing on every proxy we tried at the moment; the status above changes as soon as a check passes again.

Try it in the Playground

Troubleshooting

The failures our own checks of medium.com ran into over the last 7 days, and what got the page in the same check.

What happenedTimesWhat fixed it
The site blocked the request (HTTP 403 or a block page) 36 None of the settings we tried got past it in 7 days.
The page did not load in time 7 Nothing we tried in the same check. Retry later, one request at a time.

A failed request is not billed: only HTTP 200 and 404 responses cost credits.

What people build with Medium data

  • Media monitoringTrack the articles published on the topics and companies you follow.More on this use case

Limits and etiquette

  • Public pages only. Pages behind a login, and data shown only to signed-in users, are out of scope.
  • Keep the rate modest: fetch pages one after another or with low concurrency, and cache what you already have.
  • robots.txt of medium.com (read 2026-10-13): public pages allowed for generic crawlers; no crawl delay set.
  • Read Medium's terms of service before you collect data at scale, and do not collect personal data you have no basis to process. This guide is not legal advice.

Questions

Can you scrape Medium with Ujeebu?

Not reliably at the moment: 0 of 19 checks passed in the last 7 days (most failures: the site blocked the request (HTTP 403 or a block page)). We are working on it; this page updates after every check.

Is it allowed to scrape Medium?

Its robots.txt allows generic crawlers on the page types in this guide. Collect public pages only, read Medium's terms of service, keep your request rate modest and do not collect personal data you have no basis to process. This is not legal advice.

How fresh is this page?

The status and settings come from our own health checks of medium.com, which run around the clock. Last check: 2026-10-13 16:06:12 UTC; no pass recorded yet.