# Publish Kit — Agentic Social Media Platform

> Publish Kit is an API-first social media management platform designed for AI agents. Create content, generate AI images & videos, upload media, publish to 9+ social platforms, and schedule posts — all programmatically via REST APIs.

## Documentation

- [API Documentation](https://publishkit.io/docs): Complete API reference with examples
- [API Docs (Machine-Readable)](https://publishkit.io/api-reference.json): OpenAPI-compatible JSON reference

## API Quick Reference

Base URL: https://publishkit.io/api/external/v1
Authentication: `X-API-Key: pk_live_your_key` or `Authorization: Bearer pk_live_your_key`

### Core Endpoints

- [Get Profile](https://publishkit.io/docs#profile): GET /api/external/v1/profile — Get profile info, credits, and stats
- [Get Connections](https://publishkit.io/docs#connections): GET /api/external/v1/connections — List connected social accounts
- [Create Post](https://publishkit.io/docs#posting): POST /api/external/v1/post — Publish or schedule posts to social platforms
- [Get Posts](https://publishkit.io/docs#posting): GET /api/external/v1/post — Retrieve post history with pagination

### Content Generation

- [Generate Post](https://publishkit.io/docs#ai-content): POST /api/content/posts/generate — AI-generated social posts with optional images
- [Generate Image](https://publishkit.io/docs#ai-images): POST /api/ai-content/images/generate — AI image generation
- [Generate Video](https://publishkit.io/docs#ai-videos): POST /api/ai-content/videos — AI video generation

### Media

- [Upload Media](https://publishkit.io/docs#media): POST /api/media/upload — Upload video/image files
- [Media with Post](https://publishkit.io/docs#media): POST /api/external/v1/post (multipart) — Upload media inline with posting

### Products & Content Library

- [Products](https://publishkit.io/docs#products): GET/POST /api/profiles/{profileId}/products — Manage products for AI context
- [Generated Content](https://publishkit.io/docs#generated-content): GET /api/profiles/{profileId}/generated-content — Browse AI-generated media library

### AI Avatars

- [Train Avatar](https://publishkit.io/docs#avatars): POST /api/ai-content/avatars/train — Train AI avatar from photos
- [Generate with Avatar](https://publishkit.io/docs#avatars): POST /api/ai-content/avatars/generate — Generate images with trained avatar

### Free Tools (No Auth)

- [Bio Generator](https://publishkit.io/docs#tools): POST /api/tools/bio-generator
- [Caption Generator](https://publishkit.io/docs#tools): POST /api/tools/caption-generator
- [Hashtag Generator](https://publishkit.io/docs#tools): POST /api/tools/hashtag-generator

## Supported Platforms

Twitter/X, LinkedIn, Instagram, Facebook, TikTok, YouTube, Pinterest, Reddit, Threads

## Authentication

API keys are created from the dashboard and scoped to a profile. Available scopes: post:create, post:read, connection:read, connection:write, profile:read, account:read.

## Credits

Operations consume credits. Key costs: Post = 1 credit, AI Post = 2, AI Image = 8, AI Video (5s) = 70. Plans: Starter ($19/mo, 1900 credits), Pro ($49/mo, 4900 credits), Business ($99/mo, 9900 credits).