Paragraph

Paragraph is a web3-native publishing and newsletter platform where writers get a website, a newsletter, an owned subscriber list, and an AI agent that drafts, distributes, and maintains their publication. It supports custom domains, Substack import, subscriber management, and onchain monetization through writer coins and post coins. Paragraph ships a full public REST API (public.api.paragraph.com), an official TypeScript SDK, a CLI, a hosted Model Context Protocol server, and published Agent Skills so developers and AI agents can manage posts, publications, subscribers, and coins programmatically. Backed by Union Square Ventures.

Paragraph publishes 10 APIs on the APIs.io network, including analytics API, auth API, coins API, and 7 more. Tagged areas include Company, Publishing, Newsletters, Web3, and Content.

Paragraph’s developer surface includes documentation, API reference, getting-started guide, engineering blog, support, pricing, signup flow, and 28 more developer resources.

🌐 Visit website 📡 Source on GitHub

60.2/100 strong ▲ 9.4 Agent 52/100 agent ready Full breakdown ↓
scored 2026-08-17 · rubric v0.11.0

AccessFreemiumSelf serveFree trial⚡ Free to try

10 APIs 1 MCP Servers

CompanyPublishingNewslettersWeb3ContentBloggingCreator EconomyAPI

Kin Score

Kin Score How this is scored →
scored 2026-08-17 · rubric v0.11.0

Composite quality — 60.2/100 · strong

Contract Quality 15.5 / 25

Developer Ergonomics 16.1 / 20

Commercial Clarity 15.3 / 20

Operational Transparency 2.7 / 13

Governance 1.4 / 12

Discoverability 9.3 / 10

Agent readiness — 52/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 3 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/paragraph: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 10

Individual APIs this provider publishes, each with its own machine-readable definition.

Open Collections 11

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Rate Limits 1

Documented rate limits and quota policies.

Scopes 1

OAuth scopes governing access to this provider's APIs.

Paragraph Scopes

OAuth 2.0 · no documented scopes

0 scopes

SCOPES

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal

DeveloperPortal

GettingStarted

GettingStarted

SignUp

SignUp

Documentation 3

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

OpenAPI

OpenAPI

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

MCPServer

AgentSkill

LLMsTxt

WellKnown

AgenticAccess

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Conventions

ErrorCatalog

Lifecycle

Conformance

DataModel

Build 5

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

Packages

SDKs

CLI

ToolCrosswalk

Access & Security 3

Authentication, authorization, and security posture

Authentication

Authentication

DomainSecurity

DomainSecurity

OAuthScopes

OAuthScopes

Operate 3

Status, limits, changes, and where to get help

Support

Support

RateLimits

RateLimits

ChangeLog

ChangeLog

Commercial 4

Pricing, plans, and the legal terms of use

Pricing

TermsOfService

PrivacyPolicy

Plans

Company 2

The organization behind the API

Blog

Blog

Website

Website

Other 2

Properties that don't map to a standard resource type

Overlay

Overlay

ContentSignal

ContentSignal

Source (apis.yml)

aid: paragraph
name: Paragraph
description: Paragraph is a web3-native publishing and newsletter platform where writers get a website, a newsletter, an owned
  subscriber list, and an AI agent that drafts, distributes, and maintains their publication. It supports custom domains,
  Substack import, subscriber management, and onchain monetization through writer coins and post coins. Paragraph ships a
  full public REST API (public.api.paragraph.com), an official TypeScript SDK, a CLI, a hosted Model Context Protocol server,
  and published Agent Skills so developers and AI agents can manage posts, publications, subscribers, and coins programmatically.
  Backed by Union Square Ventures.
url: https://raw.githubusercontent.com/api-evangelist/paragraph/refs/heads/main/apis.yml
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: true
  try_now: true
  public: true
  label: Free tier with self-serve signup
  confidence: high
  source:
  - https://docs.paragraph.com/account/plans-and-credits
  - https://paragraph.com/pricing
  - plans/paragraph-plans-pricing.yml
  generated: '2026-08-13'
  method: searched
  note: Free plan ($0/mo, 500 agent credits, limited API and MCP access) through Scale ($200/mo) plus a custom Enterprise
    tier. Many REST reads (search, feed, public publication/post fetch) require no credential at all.
image: https://paragraph.com/og.png
x-type: company
x-source: vc-portfolio
x-backed-by:
- union-square-ventures
x-tier: enriched
x-tier-reason: portfolio-lead
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-08-13'
tags:
- Company
- Publishing
- Newsletters
- Web3
- Content
- Blogging
- Creator Economy
- API
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
apis:
- aid: paragraph:paragraph-analytics-api
  name: Paragraph analytics API
  description: The analytics API from Paragraph — 2 operation(s) for analytics.
  humanURL: https://docs.paragraph.com/developers
  baseURL: https://public.api.paragraph.com/api
  tags:
  - analytics
  properties:
  - type: OpenAPI
    url: openapi/paragraph-analytics-api-openapi.yml
  - type: APIReference
    url: https://docs.paragraph.com/api-reference
  - type: Documentation
    url: https://docs.paragraph.com
- aid: paragraph:paragraph-auth-api
  name: Paragraph auth API
  description: The auth API from Paragraph — 2 operation(s) for auth.
  humanURL: https://docs.paragraph.com/developers
  baseURL: https://public.api.paragraph.com/api
  tags:
  - auth
  properties:
  - type: OpenAPI
    url: openapi/paragraph-auth-api-openapi.yml
  - type: APIReference
    url: https://docs.paragraph.com/api-reference
  - type: Documentation
    url: https://docs.paragraph.com
- aid: paragraph:paragraph-coins-api
  name: Paragraph coins API
  description: Operations related to tokenized content
  humanURL: https://docs.paragraph.com/developers
  baseURL: https://public.api.paragraph.com/api
  tags:
  - coins
  properties:
  - type: OpenAPI
    url: openapi/paragraph-coins-api-openapi.yml
  - type: APIReference
    url: https://docs.paragraph.com/api-reference
  - type: Documentation
    url: https://docs.paragraph.com
- aid: paragraph:paragraph-discover-api
  name: Paragraph discover API
  description: The discover API from Paragraph — 3 operation(s) for discover.
  humanURL: https://docs.paragraph.com/developers
  baseURL: https://public.api.paragraph.com/api
  tags:
  - discover
  properties:
  - type: OpenAPI
    url: openapi/paragraph-discover-api-openapi.yml
  - type: APIReference
    url: https://docs.paragraph.com/api-reference
  - type: Documentation
    url: https://docs.paragraph.com
- aid: paragraph:paragraph-emails-api
  name: Paragraph emails API
  description: The emails API from Paragraph — 1 operation(s) for emails.
  humanURL: https://docs.paragraph.com/developers
  baseURL: https://public.api.paragraph.com/api
  tags:
  - emails
  properties:
  - type: OpenAPI
    url: openapi/paragraph-emails-api-openapi.yml
  - type: APIReference
    url: https://docs.paragraph.com/api-reference
  - type: Documentation
    url: https://docs.paragraph.com
- aid: paragraph:paragraph-me-api
  name: Paragraph me API
  description: The me API from Paragraph — 1 operation(s) for me.
  humanURL: https://docs.paragraph.com/developers
  baseURL: https://public.api.paragraph.com/api
  tags:
  - me
  properties:
  - type: OpenAPI
    url: openapi/paragraph-me-api-openapi.yml
  - type: APIReference
    url: https://docs.paragraph.com/api-reference
  - type: Documentation
    url: https://docs.paragraph.com
- aid: paragraph:paragraph-posts-api
  name: Paragraph posts API
  description: Operations related to posts and content
  humanURL: https://docs.paragraph.com/developers
  baseURL: https://public.api.paragraph.com/api
  tags:
  - posts
  properties:
  - type: OpenAPI
    url: openapi/paragraph-posts-api-openapi.yml
  - type: APIReference
    url: https://docs.paragraph.com/api-reference
  - type: Documentation
    url: https://docs.paragraph.com
- aid: paragraph:paragraph-publications-api
  name: Paragraph publications API
  description: Operations related to publications
  humanURL: https://docs.paragraph.com/developers
  baseURL: https://public.api.paragraph.com/api
  tags:
  - publications
  properties:
  - type: OpenAPI
    url: openapi/paragraph-publications-api-openapi.yml
  - type: APIReference
    url: https://docs.paragraph.com/api-reference
  - type: Documentation
    url: https://docs.paragraph.com
- aid: paragraph:paragraph-subscribers-api
  name: Paragraph subscribers API
  description: Operations related to subscriber management (requires API key)
  humanURL: https://docs.paragraph.com/developers
  baseURL: https://public.api.paragraph.com/api
  tags:
  - subscribers
  properties:
  - type: OpenAPI
    url: openapi/paragraph-subscribers-api-openapi.yml
  - type: APIReference
    url: https://docs.paragraph.com/api-reference
  - type: Documentation
    url: https://docs.paragraph.com
- aid: paragraph:paragraph-users-api
  name: Paragraph users API
  description: Operations related to users and authors
  humanURL: https://docs.paragraph.com/developers
  baseURL: https://public.api.paragraph.com/api
  tags:
  - users
  properties:
  - type: OpenAPI
    url: openapi/paragraph-users-api-openapi.yml
  - type: APIReference
    url: https://docs.paragraph.com/api-reference
  - type: Documentation
    url: https://docs.paragraph.com
common:
- type: DeveloperPortal
  url: https://docs.paragraph.com/developers
- type: Documentation
  url: https://docs.paragraph.com
- type: APIReference
  url: https://docs.paragraph.com/api-reference
- type: GettingStarted
  url: https://docs.paragraph.com/getting-started/quickstart
- type: GitHubOrganization
  url: https://github.com/paragraph-xyz
- type: Blog
  url: https://paragraph.com/@blog
- type: Support
  url: https://docs.paragraph.com/developers
- type: Pricing
  url: https://paragraph.com/pricing
- type: SignUp
  url: https://app.paragraph.com
- type: TermsOfService
  url: https://paragraph.com/terms-of-use
- type: PrivacyPolicy
  url: https://paragraph.com/privacy
- type: OpenAPI
  url: openapi/_original/paragraph-openapi-original.json
- type: Overlay
  url: overlays/paragraph-openapi-overlay.yaml
- type: Authentication
  url: authentication/paragraph-authentication.yml
- type: Packages
  url: packages/paragraph-packages.yml
- type: SDKs
  url: packages/paragraph-packages.yml
- type: CLI
  url: cli/paragraph-cli.yml
- type: MCPServer
  url: mcp/paragraph-mcp.yml
- type: AgentSkill
  url: skills/_index.yml
- type: LLMsTxt
  url: llms/paragraph-llms.txt
- type: WellKnown
  url: well-known/paragraph-well-known.yml
- type: Conventions
  url: conventions/paragraph-conventions.yml
- type: ErrorCatalog
  url: errors/paragraph-problem-types.yml
- type: Lifecycle
  url: lifecycle/paragraph-lifecycle.yml
- type: Conformance
  url: conformance/paragraph-conformance.yml
- type: DataModel
  url: data-model/paragraph-data-model.yml
- type: AgenticAccess
  url: agentic-access/paragraph-agentic-access.yml
- type: DomainSecurity
  url: security/paragraph-domain-security.yml
- type: OAuthScopes
  url: scopes/paragraph-scopes.yml
- type: Plans
  url: plans/paragraph-plans-pricing.yml
- type: RateLimits
  url: rate-limits/paragraph-rate-limits.yml
- type: ChangeLog
  url: changelog/paragraph-changelog.yml
- type: ToolCrosswalk
  url: mcp/paragraph-tool-crosswalk.yml
- type: ContentSignal
  url: well-known/paragraph-robots.txt
- type: Website
  url: https://paragraph.com
x-enrichment:
  date: '2026-08-13'
  status: enriched
  artifacts_added: 11
  pass: local-v1