Social
Feeds and follows you don’t have to build.
Add ranked feeds, follows, stories, direct messages and moderation to your app through one API. You keep your own user accounts: Social only needs your id for each person.
Ranked feeds you can tune.
Each person’s feed is ranked by how recent a post is, how much it is talked about and who they follow. Change that balance for each community, with no machine-learning pipeline to run.
The whole set, not a demo.
Follows and blocks, direct and group messages, stories that expire, polls, close-friends lists and video uploads up to 512 MB. Each one is a ready API call, not a feature you build.
Moderation built in.
People report posts and comments, and reports land in a review queue. Set how many reports hide a post on their own, and which words hold a comment for review, for each community.
Use it on its own.
Social works with the user accounts you already have. Give each person your own id for them, and no ProductCraft Auth app is needed.
How it works
Your first feed in three steps.
- Create a community in the console or with one call.
- Add a profile for each of your users, under your own id for them.
- Follow, post, and read each person’s ranked feed.
import { Social } from "@productcraft/social";
// Reads PRODUCTCRAFT_API_KEY from the environment
const social = new Social();
// A community of its own: no Auth app needed.
const { id } = await social.communities.create({
slug: "book-club",
display_name: "Book Club",
});
const community = social.community(id);
// A profile for each of your users, under your own ids for them.
const { actor: ada } = await community.actors.create({
external_id: "user_1",
display_name: "Ada",
});
const { actor: grace } = await community.actors.create({
external_id: "user_2",
display_name: "Grace",
});
// Grace follows Ada, Ada posts, and the post lands in Grace's feed.
await community.as(grace.id).follows.create({ dst_actor_id: ada.id });
await community.as(ada.id).posts.create({ body: "Chapter one, done." });
const feed = await community.actors.feed.list(grace.id);
console.log(feed.data[0]?.body);More in the box
Everything else Social does.
- Comments and replies Threaded comments up to a depth you set, reactions on posts and comments, and pinned comments.
- Who can see a post Everyone, followers only, close friends, or just the author.
- Search and hashtags Search posts and people, and let people follow a hashtag.
- Suggested follows Suggestions for who to follow next, which people can dismiss.
- Notifications Each person’s list of new followers, reactions, replies, mentions and messages, with an unread count.
- Shadow bans and an audit log Hide someone’s posts from everyone but them, and keep a record of every moderator action that nobody can edit.
- Erasure on request Delete a person, and their posts, comments, follows and notifications go with them.
- Signed webhooks Events for posts, comments, reports and profile changes, with Send test and replay.
- Hosted in the EU Social runs in Frankfurt with the rest of ProductCraft.
For your AI agents
MCP tools for communities, profiles, posts and moderation, behind the policies you set on each key, so you decide whether an agent may only read a community or also moderate it. Read about MCP
Your first community, end to end.
Create a community, add two people, and see one person’s post in the other’s feed.