Posts API

Fetch a paginated feed of posts from any Substack publication. Each post includes title, subtitle, publication date, cover image, word count, like count, and comment count. Supports offset-based pagination with configurable limits.

GET/v1/publications/:slug/posts

Highlights

Paginated with offset and limit parameters

Title, subtitle, and cover image for each post

Word count and reading time estimates

Engagement stats: likes, comments, shares

Publication date and last updated timestamp

Free vs paid post classification

Code Example

javascript

const res = await fetch(
  "https://stackhooks.com/v1/publications/platformer/posts?limit=5&offset=0",
  { headers: { Authorization: "Bearer sk_live_..." } }
);
const { data, pagination } = await res.json();
console.log(`${pagination.total} total posts`);
data.forEach(p => console.log(p.title));

Response

json

{
  "data": [
    {
      "slug": "the-ai-wars-begin",
      "title": "The AI wars begin",
      "subtitle": "...",
      "date": "2024-12-15T12:00:00Z",
      "word_count": 2340,
      "like_count": 456,
      "is_paid": false
    }
  ],
  "pagination": { "offset": 0, "limit": 5, "total": 892 }
}

Full API reference →