Skip to main content
The Matter API gives you full read/write access to your library. Save articles, manage annotations, organize with tags, and sync your reading data with any tool you use.
The API requires a Matter Pro subscription. Upgrade to Pro to get started.

​
Base URL

https://api.getmatter.com/public/v1/

​
Authentication

All endpoints require a Bearer token in the Authorization header: 
curl https://api.getmatter.com/public/v1/me \
  -H "Authorization: Bearer mat_your_token_here"
See Authentication for details on generating and managing tokens.

​
Request format

  • All request bodies must be JSON with Content-Type: application/json
  • Query parameters are used for filtering and pagination
  • IDs in URLs are prefixed strings (e.g., itm_r9f3a)

​
Response format

All responses are JSON. Every object includes an object field identifying its type. Single resource: 
{
  "object": "item",
  "id": "itm_r9f3a",
  "title": "Example Article"
}
List of resources: 
{
  "object": "list",
  "results": [...],
  "has_more": true,
  "next_cursor": "eyJpZCI6MTIzNH0="
}
Error: 
{
  "error": {
    "code": "not_found",
    "message": "No item found with ID itm_abc123."
  }
}

​
Getting started

Quickstart

Save your first article and retrieve your library in under 5 minutes.

Authentication

Generate and manage your API token.

IDs & Object Types

How resources are identified in the API.

​
Concepts

Pagination

Cursor-based pagination and incremental sync.

Rate Limits

Request quotas and how to handle throttling.

Errors

Error codes, status codes, and how to handle them.

Versioning

API versioning and compatibility guarantees.

​
API Reference

Items

Articles, podcasts, videos, and everything in your library.

Annotations

Text highlights and notes you’ve made while reading.

Tags

Labels you use to organize items in your library.

Search

Full-text search across your library.

Account

Your profile and API quota.