Everything your Paragraph agent works with is also available to your own code. Publish posts, upload drafts to the publication's library, and manage subscribers from scripts, CI jobs, or other AI tools.

The API is in alpha, so expect some breaking changes. It's also rate-limited. If you need a higher limit, email support@paragraph.com.

Authentication

Reading public posts and publications doesn't need a key. Writing, and reading your own drafts or subscribers, does. Create an API key in the app at app.paragraph.com under Settings → API keys. Each key belongs to one publication.

Send it as a Bearer token to the base URL https://public.api.paragraph.com/api:

curl https://public.api.paragraph.com/api/v1/me \
  -H "Authorization: Bearer your-api-key"

The API reference lists every endpoint, and the OpenAPI spec works with code generators and tools like Postman.

Docs for AI tools

This site serves llms.txt and llms-full.txt, and every page has a Markdown version (add .md to the URL). Give llms-full.txt to an LLM to load all of these docs in one go.

On this page