Content

Public Posts

Read published posts and resolve short URLs without authentication.

Public Posts

Published posts are accessible to anyone without authentication. Use these endpoints to display PingRep content on external websites, build content aggregators, or resolve short share links.

Get a published post

GET
/api/v1/public/posts/{username}/{slug}
Public

Retrieve a published post by the author's username and post slug.

Response

titlestringRequired

Post title.

slugstringRequired

URL-safe post identifier.

bodyMarkdownstringRequired

Full post content in Markdown.

tagsstring[]Required

Topic tags.

coverImageUrlstringRequired

Cover image URL.

suggestedQuestionsstring[]Required

AI Representative prompt suggestions for this post.

publishedAtstring (ISO 8601)Required

Publication timestamp.

authorobjectRequired

Author profile summary.

namestringRequired

Author name.

slugstringRequired

Author profile slug.

photoUrlstringRequired

Author photo URL.

titlestringRequired

Author professional title.

List a user's published posts

GET
/api/v1/public/posts/{username}
Public

List all published posts for a given user.

Returns posts ordered by publication date (newest first). Only published posts are included.

Resolve a short URL

GET
/api/v1/public/s/{shortCode}
Public

Resolve a short share code to the full post URL. Returns a 302 redirect.

When users share posts, PingRep generates short URLs for easy distribution. This endpoint resolves the short code and redirects to the full post.

Short URLs are generated automatically when a post is published. You do not need to create them manually. The short code is included in the post response object.