List Medium publication posts
List a publication's ten newest Medium posts by Medium slug or its own domain, optionally filtered by tag.
Headers
Get your API keyAPI key (`sfk_...`)
Medium publication slug (`netflix-techblog`) or its own domain (`uxdesign.cc`).
min 1 chars · max 253 chars · pattern: ^[a-z0-9][a-z0-9.-]*$
The publication's own domain (`uxdesign.cc`), when it runs on one. Overrides the slug.
min 3 chars · max 253 chars
Only posts of the publication carrying this tag (medium.com publications only; not supported on a custom domain).
min 1 chars · max 64 chars · pattern: ^[^\s/?#&=\u0000-\u001f\u007f-\u009f]+$
Endpoint-specific response payload.
Whether the entity exists. HTTP 200 for both outcomes.
one of: found, not_found
The publication's feed header; null when the publication does not exist.
Publication slug or domain asked for.
Publication name, from the feed title.
Feed title.
Feed description, without Medium's suffix.
Collection id, when the feed carries one.
Public link to the publication on Medium.
Host of the public link.
True when the publication runs on its own domain.
The newest 10 posts (every match for the tag filter).
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/publications/netflix-techblog/posts?tag=ios" \
-H "x-api-key: YOUR_API_KEY"Responses
The publication's newest posts.