Developers
Build with PUBlish.
Every public read endpoint, the MCP server, webhooks, embed widgets, and plugins — all free, all auth-free, all CORS-open. No API key needed for reads. Full integration tour →
30-second quickstart
cURL · REST API
# Find PUBlish writers covering a topic
curl 'https://pub-lish.com/api/public/authors/search?q=ai+policy&limit=5'
# Get one author's full profile
curl 'https://pub-lish.com/api/public/authors/jane-novak'
# Cross-author recent feed, filtered by category
curl 'https://pub-lish.com/api/public/pieces/recent?category=building&limit=10'
# Full-text search across piece content
curl 'https://pub-lish.com/api/public/pieces/search?q=hiring+engineers'
# One piece by id, full body
curl 'https://pub-lish.com/api/public/pieces/<piece-id>'MCP · Claude Desktop
// Claude Desktop config (claude_desktop_config.json)
{
"mcpServers": {
"publish": {
"type": "http",
"url": "https://pub-lish.com/api/mcp"
}
}
}HTML · Embed
<!-- One-paste widget — works on any site -->
<div data-publish-widget="card" data-slug="jane-novak"></div>
<script src="https://pub-lish.com/embed.js" defer></script>
<!-- Live SVG badge -->
<a href="https://pub-lish.com/author/jane-novak" rel="me">
<img src="https://pub-lish.com/embed/jane-novak/badge.svg" alt="jane-novak on PUBlish" height="44" />
</a>Surfaces
Public · auth-free
REST API
Pull author profiles, search authors, list and search pieces. Cross-author recent feed. CORS-open, no API key.
GET /api/public/*Native AI tools
MCP server
Model Context Protocol. Eight tools — content (search_authors, get_author, recent_pieces, get_piece, search_pieces, trending_pieces) + shop (search_products, get_product). Add to Claude Desktop, Cursor, any MCP client.
POST /api/mcpAI-readable products
Shop catalogue for AI
llms-products.txt at root — every listing (name, seller, price, category, Stripe URL, writing behind it) in one plain-text crawl. Companion to llms.txt but scoped to buyer-intent queries.
/llms-products.txtBearer · drafts only
Write API
POST a piece into PUBlish from your CMS, Zapier, n8n, or AI agent. Every API-created piece lands as a draft — the writer publishes manually. The editorial gate stays in the writer's hands.
POST /api/v1/piecesTry it live
Interactive API reference
Every endpoint with parameters, response schemas, and an inline "Try it" panel that fires real requests. Code generators for cURL, Node, Python, Go, and more.
Live + interactiveAuto-generate clients
OpenAPI 3.1 spec
Formal spec of every public endpoint. Drop into Postman / Insomnia / openapi-typescript / swagger-codegen.
/api/openapi.jsonReal-time push
Publish webhook
Auto-syndicate to your own site or CMS. Writer configures URL, PUBlish POSTs every new piece with HMAC signature. JSON Feed item shape.
X-Publish-SignatureOne-paste install
Embed widgets
Universal <script> that renders badge, card, list, or bio widgets on any site. Also a static SVG badge for stores that block scripts.
embed.js · badge.svgPer-author feeds
JSON Feed + RSS
Every author has /author/<slug>/feed.json (JSON Feed 1.1) and /feed.xml (RSS). Subscribe directly or import via Feedly, Readwise, Inoreader.
/author/<slug>/feed.jsonPlugins
Shopify Theme App
Theme App Extension for Shopify stores. Merchants add the PUBlish Author Badge block to any theme section, enter their username, done.
In Shopify reviewPlugins
WordPress plugin
PUBlish Author Badge for WordPress / WooCommerce. Shortcode, Gutenberg block, classic widget, settings page with live preview.
[publish_badge]Machine-readable
LLM discovery
llms.txt with the full URL inventory + /.well-known/mcp.json with the MCP server manifest. AI crawlers find every surface automatically.
/llms.txt