---
title: "List a Medium writer’s stories"
method: GET
path: "/v1/medium/profile/posts"
tags: ["Medium"]
---

# List a Medium writer’s stories

`GET /v1/medium/profile/posts`

## Request

- Base URL: `https://api.scrapeatlas.com`
- URL: `https://api.scrapeatlas.com/v1/medium/profile/posts`
- Auth: API key in header `x-api-key`

List a writer’s public Medium stories with titles, author and publication details, topics, dates, clap and response counts, and source content. Pass nextCursor as cursor to read the next source page. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

## Query parameters

- `handle` string, required
- `limit` string
- `cursor` string

## Response `200`

Inspect the response status and failure or coverage fields.

- union
  - object
    - `requestId` string, uuid, required
    - `accounting` object, required
      - `upstreamRequests` integer, required
      - `responseBytes` integer, required
      - `durationMs` number, required
    - `success` true, required
    - `status` 'success' | 'partial', required
    - `sourceUrl` string, uri, required
    - `fetchedAt` string, date-time, required
    - `coverage` object, required
      - `source` 'public_web', required
      - `complete` boolean, required
      - `warnings` string[], required
      - `order` 'source_order' | 'ranked'
    - `posts` object[], required
      - `id` string, required
      - `title` string, nullable, required
      - `subtitle` string, nullable, required
      - `slug` string, nullable, required
      - `uniqueSlug` string, nullable, required
      - `url` string, nullable, required
      - `canonicalUrl` string, nullable, required
      - `creatorId` string, nullable, required
      - `publicationId` string, nullable, required
      - `language` string, nullable, required
      - `createdAt` integer, nullable, required
      - `updatedAt` integer, nullable, required
      - `firstPublishedAt` integer, nullable, required
      - `latestPublishedAt` integer, nullable, required
      - `clapCount` integer, nullable, required
      - `responseCount` integer, nullable, required
      - `readingTime` number, nullable, required
      - `wordCount` integer, nullable, required
      - `memberOnly` boolean, nullable, required
      - `previewOnly` boolean, nullable, required
      - `responsesLocked` boolean, nullable, required
      - `parentId` string, nullable, required
      - `imageUrl` string, nullable, required
      - `tags` object[], required
        - `slug` string, required
        - `name` string, nullable, required
        - `postCount` integer, nullable, required
      - `author` object, nullable, required
        - `id` string, required
        - `username` string, required
        - `name` string, nullable, required
        - `bio` string, nullable, required
        - `url` string, nullable, required
        - `imageId` string, nullable, required
        - `imageUrl` string, nullable, required
        - `backgroundImageId` string, nullable, required
        - `createdAt` integer, nullable, required
        - `mediumMemberAt` integer, nullable, required
        - `languageCode` string, nullable, required
        - `twitterScreenName` string, nullable, required
        - `facebookDisplayName` string, nullable, required
        - `followerCount` integer, nullable, required
        - `followingCount` integer, nullable, required
        - `postCount` integer, nullable, required
        - `isSuspended` boolean, nullable, required
      - `authorName` string, nullable, required
      - `publication` object, nullable, required
        - `id` string, required
        - `name` string, nullable, required
        - `slug` string, nullable, required
        - `url` string, nullable, required
        - `description` string, nullable, required
        - `shortDescription` string, nullable, required
        - `tagline` string, nullable, required
        - `creatorId` string, nullable, required
        - `subscriberCount` integer, nullable, required
        - `imageUrl` string, nullable, required
        - `logoUrl` string, nullable, required
        - `faviconUrl` string, nullable, required
        - `twitterUsername` string, nullable, required
        - `facebookPageName` string, nullable, required
        - `instagramUsername` string, nullable, required
        - `publicEmail` string, nullable, required
        - `editorsNote` string, nullable, required
        - `staff` object[], nullable, required
          - `userId` string, required
          - `isEditor` boolean, nullable, required
          - `excluded` boolean, nullable, required
          - `type` string, nullable, required
          - `profile` object, nullable, required
            - `id` string, required
            - `username` string, required
            - `name` string, nullable, required
            - `bio` string, nullable, required
            - `url` string, nullable, required
            - `imageId` string, nullable, required
            - `imageUrl` string, nullable, required
            - `backgroundImageId` string, nullable, required
            - `createdAt` integer, nullable, required
            - `mediumMemberAt` integer, nullable, required
            - `languageCode` string, nullable, required
            - `twitterScreenName` string, nullable, required
            - `facebookDisplayName` string, nullable, required
            - `followerCount` integer, nullable, required
            - `followingCount` integer, nullable, required
            - `postCount` integer, nullable, required
            - `isSuspended` boolean, nullable, required
        - `tags` string[], required
      - `paragraphs` object[], required
        - `name` string, nullable, required
        - `type` union, required
          - integer
          - string
        - `text` string, required
        - `imageId` string, nullable, required
        - `mediaResourceId` string, nullable, required
        - `markups` object[], required
          - `type` union, required
            - integer
            - string
          - `start` integer, nullable, required
          - `end` integer, nullable, required
          - `href` string, nullable, required
          - `userId` string, nullable, required
      - `text` string, nullable, required
      - `contentHtml` string, nullable, required
      - `links` string[], required
    - `nextCursor` string, nullable, required
    - `limit` integer, required
  - object
    - `requestId` string, uuid, required
    - `accounting` object, required
      - `upstreamRequests` integer, required
      - `responseBytes` integer, required
      - `durationMs` number, required
    - `success` false, required
    - `status` 'failed' | 'challenged', required
    - `failure` object, required
      - `code` 'invalid_request' | 'unauthorized' | 'not_found' | 'restricted_page' | 'upstream_challenged' | 'upstream_rate_limited' | 'upstream_error' | 'unsupported_page' | 'response_too_large' | 'unsafe_redirect' | 'request_limit' | 'timeout' | 'busy' | 'payload_too_complex', required
      - `message` string, required

## Other responses

- `400`: Request could not complete; inspect error or failure.code.
- `401`: Request could not complete; inspect error or failure.code.
- `402`: Request could not complete; inspect error or failure.code.
- `403`: Request could not complete; inspect error or failure.code.
- `404`: Request could not complete; inspect error or failure.code.
- `408`: Request could not complete; inspect error or failure.code.
- `413`: Request could not complete; inspect error or failure.code.
- `429`: Request could not complete; inspect error or failure.code.
- `500`: Request could not complete; inspect error or failure.code.
- `502`: Request could not complete; inspect error or failure.code.
- `503`: Request could not complete; inspect error or failure.code.
- `504`: Request could not complete; inspect error or failure.code.

---

[API](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api.md) · [All operations](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api/revisions/9ba049316894?raw)