List Medium author posts
List an author's ten newest Medium posts, with the full article HTML when the article body is available.
Headers
Get your API keyAPI key (`sfk_...`)
Medium handle, with or without the leading `@`, e.g. `ev`.
min 1 chars · max 64 chars · pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
Endpoint-specific response payload.
Whether the entity exists. HTTP 200 for both outcomes.
one of: found, not_found
The author's feed header; null when the author does not exist.
Handle without the `@`.
Display name, from the feed title.
Feed title.
Feed description.
User id, when the feed carries one.
Avatar URL from the feed image.
Public link to the author on Medium.
Host of the public link.
True when the public link is not on medium.com.
The newest 10 posts, across every publication the author writes for. Items carry full HTML when the article body is available.
Post id (the hex id after `/p/`).
Title as Medium has it.
Public link to the post.
Author display name.
Author handle when the post's public link names one (`medium.com/@handle/...` or `{handle}.medium.com/...`); null when it does not, including on a `medium.com/{publication}/...` link or a publication's own domain.
Publication slug when the post's public link names one (`medium.com/{slug}/...`); null when it does not, including on an author's post or a publication's own domain.
Tag slugs on the post.
First publication time, ISO 8601 UTC.
When the post was last updated, ISO 8601 UTC.
Host of the public link.
True when the link is on a publication's own domain.
True when the article body is available. A member-only or preview-only item is false.
Article HTML when the post body is available.
Plain text derived from `contentHtml`.
Short preview for an item without an article body.
First image of the post, when it has one.
Words in `contentText`, derived from the article text (Chinese, Japanese and Thai are segmented). Null when the body is not available.
Words divided by 238, to one decimal.
False when an item could not be fully parsed; the response then holds the complete items.
Depth of a list. It has no cursor.
The depth of this list: 10.
≥ 0
Always null: this list has no paging parameter, so whether anything older exists is not known.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/medium/authors/ev/posts" \
-H "x-api-key: YOUR_API_KEY"Responses
The author's newest posts.