String docs
Site integrations

Medium

A Medium writer's public profile and their own published stories, newest first.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

  • Site: medium
  • Version: 1.0.0
  • Reads from: medium.com
ActionDescriptionListed price
profileRead a Medium writer's public profile: name, bio, avatar, follower and following counts, their subdomain or custom domain, the X (Twitter) and Mastodon accounts they linked, and membership. Name one writer as profile, or up to 25 as profiles.Billed per request at your plan's rates
postsRead a Medium writer's own published stories, newest first: each story's title, subtitle, URL, publish and update times, claps, response count, reading time, paywall flag, tags and publication.Billed per request at your plan's rates

profile

Read a Medium writer's public profile: name, bio, avatar, follower and following counts, their subdomain or custom domain, the X (Twitter) and Mastodon accounts they linked, and membership. Name one writer as profile, or up to 25 as profiles.

POST https://request.usestring.ai/v1/integrations/medium/profile

Input

Unknown fields are rejected.

FieldTypeDescription
profilestringThe writer: their username, such as ev, or their profile URL, such as https://medium.com/@ev or https://ev.medium.com. Give profile or profiles. At least 1 character.
profilesstring[]Up to 25 writers, each in any form profile takes, to read in one call. Give profile or profiles. 1 to 25 entries.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
idstringMedium's user id.
usernamestring—
namestring—
biostring | null—
profileUrlstring—
customDomainstring | nullThe writer's live subdomain or custom domain, such as ev.medium.com.
avatarUrlstring | null—
followerCountinteger | null—
followingCountinteger | null—
twitterScreenNamestring | nullThe X (Twitter) handle the writer linked, without the @.
mastodonstring | nullThe Mastodon account the writer linked, as @user@domain.
isBookAuthorboolean—
memberSincestring | nullWhen the writer joined Medium's paid membership, RFC 3339, UTC; null when not a member.
isSuspendedboolean—

Example

curl https://request.usestring.ai/v1/integrations/medium/profile \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile": "ev"
  }'

data starts with these rows:

[
  {
    "id": "268314bb7e7e",
    "username": "ev",
    "name": "Ev Williams",
    "bio": "Curious human, cofounder @ Mozi, chairman @ Medium, partner @ Obvious Ventures",
    "profileUrl": "https://medium.com/@ev",
    "customDomain": "ev.medium.com",
    "avatarUrl": "https://miro.medium.com/v2/resize:fill:176:176/1*Oa7aZoW8TPZrQjlKYzH5dg.jpeg",
    "followerCount": 213218,
    "followingCount": 2704,
    "twitterScreenName": null,
    "mastodon": null,
    "isBookAuthor": false,
    "memberSince": "2017-02-13T19:37:08Z",
    "isSuspended": false
  }
]

Requests and billing

  • Requests: 1 Web Access request per entry in items.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

posts

Read a Medium writer's own published stories, newest first: each story's title, subtitle, URL, publish and update times, claps, response count, reading time, paywall flag, tags and publication.

POST https://request.usestring.ai/v1/integrations/medium/posts

Input

Unknown fields are rejected.

FieldTypeDescription
profilestringRequired. The writer: their username, such as ev, or their profile URL, such as https://medium.com/@ev or https://ev.medium.com. At least 1 character.
pagesintegerThe most pages to read, 1 to 10, up to 25 stories a page, newest first. Defaults to 1. From 1 to 10.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
idstring—
titlestring—
subtitlestring | nullThe preview text Medium shows under the title.
urlstring—
publishedAtstring | nullFirst published, RFC 3339, UTC.
updatedAtstring | nullLast republished, RFC 3339, UTC.
clapCountinteger | null—
responseCountinteger | nullHow many responses (comments) the story has.
readingTimeMinutesnumber | nullMedium's reading-time estimate, to one decimal.
memberOnlybooleanWhether the story is behind Medium's paywall.
tagsstring[] | nullMay be absent.
publicationstring | nullThe publication the story ran in, when it ran in one.
publicationSlugstring | null—
previewImageUrlstring | null—
authorUsernamestring—

Example

curl https://request.usestring.ai/v1/integrations/medium/posts \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile": "ev",
    "pages": 2
  }'

data starts with these rows:

[
  {
    "id": "0126fa5c6ce8",
    "title": "Making “Social” Social Again",
    "subtitle": "Announcing Mozi",
    "url": "https://ev.medium.com/making-social-social-again-0126fa5c6ce8",
    "publishedAt": "2024-12-12T17:11:33Z",
    "updatedAt": "2025-05-19T19:09:35Z",
    "clapCount": 3634,
    "responseCount": 104,
    "readingTimeMinutes": 7.6,
    "memberOnly": false,
    "tags": ["social", "relationships", "startupş"],
    "publication": null,
    "publicationSlug": null,
    "previewImageUrl": "https://miro.medium.com/v2/resize:fit:1400/1*NMXyOoeQu3L1ZAXqf8QIYw.jpeg",
    "authorUsername": "ev"
  },
  {
    "id": "3622b4ddc3d8",
    "title": "Do not disturb",
    "subtitle": "Can I assume when you’re in the zone\nYou’re not distracted by your phone\nShould I hold my texts\nAnd take time to reflect\nOr fire away…",
    "url": "https://ev.medium.com/do-not-disturb-3622b4ddc3d8",
    "publishedAt": "2023-12-09T23:33:25Z",
    "updatedAt": "2023-12-09T23:33:25Z",
    "clapCount": 1813,
    "responseCount": 27,
    "readingTimeMinutes": 0.6,
    "memberOnly": false,
    "publication": null,
    "publicationSlug": null,
    "previewImageUrl": "https://miro.medium.com/v2/resize:fit:1400/0*WOkV9HwoEWQFjcDY",
    "authorUsername": "ev"
  }
]

Requests and billing

  • Requests: 1 Web Access request per result page.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.