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
| Action | Description | Listed price |
|---|---|---|
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. | Billed per request at your plan's rates |
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. | 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/profileInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
profile | string | The 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. |
profiles | string[] | 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:
| Field | Type | Description |
|---|---|---|
id | string | Medium's user id. |
username | string | — |
name | string | — |
bio | string | null | — |
profileUrl | string | — |
customDomain | string | null | The writer's live subdomain or custom domain, such as ev.medium.com. |
avatarUrl | string | null | — |
followerCount | integer | null | — |
followingCount | integer | null | — |
twitterScreenName | string | null | The X (Twitter) handle the writer linked, without the @. |
mastodon | string | null | The Mastodon account the writer linked, as @user@domain. |
isBookAuthor | boolean | — |
memberSince | string | null | When the writer joined Medium's paid membership, RFC 3339, UTC; null when not a member. |
isSuspended | boolean | — |
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/postsInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
profile | string | Required. 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. |
pages | integer | The 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:
| Field | Type | Description |
|---|---|---|
id | string | — |
title | string | — |
subtitle | string | null | The preview text Medium shows under the title. |
url | string | — |
publishedAt | string | null | First published, RFC 3339, UTC. |
updatedAt | string | null | Last republished, RFC 3339, UTC. |
clapCount | integer | null | — |
responseCount | integer | null | How many responses (comments) the story has. |
readingTimeMinutes | number | null | Medium's reading-time estimate, to one decimal. |
memberOnly | boolean | Whether the story is behind Medium's paywall. |
tags | string[] | null | May be absent. |
publication | string | null | The publication the story ran in, when it ran in one. |
publicationSlug | string | null | — |
previewImageUrl | string | null | — |
authorUsername | string | — |
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.
Bluesky
Bluesky profiles, an account's posts and replies with permalinks and exact timestamps back to its first post, and account search by name or handle.
Pinterest profiles, their boards and the pins they saved, as Pinterest's logged-out web app answers: a profile's name, about text, website and linked Instagram, every board with its name and pin count, and each saved pin's title, description, outbound link, board and save time.