API

Build with Mato.

Integrate AI podcasts into your workflow with our enterprise-grade API. Create episodes programmatically, schedule live interviews, manage AI hosts, and automate publishing to any platform. Full documentation, SDKs, and developer support included with all plans.

API Capabilities

Everything you need to automate podcasts.

The Mato API provides programmatic access to every feature of our platform. Build custom integrations, automate workflows, and scale your podcast operations.

Create Episodes

Generate podcast episodes programmatically with full control over topics, hosts, and duration.

Schedule Interviews

Book live AI interviews with guests, manage scheduling, and send automated invitations.

Manage AI Hosts

Configure host personalities, customize voice profiles, and assign hosts to shows.

Automate Publishing

Distribute episodes to Spotify, Apple Podcasts, YouTube, and custom destinations automatically.

Access Analytics

Retrieve detailed performance metrics, listener data, and engagement insights via API.

Quick Start

Create your first episode in minutes.

Get started with just a few lines of code. Install our SDK and create your first AI-hosted podcast episode programmatically.

JavaScript
const mato = require('@mato/sdk');

// Initialize with your API key
mato.init({ apiKey: 'your_api_key' });

// Create a new episode
const episode = await mato.episodes.create({
  host: 'maya-conversational',
  topic: 'AI in Healthcare',
  duration: '15min',
  style: 'interview'
});

// Schedule a live interview with a guest
const interview = await mato.interviews.schedule({
  episodeId: episode.id,
  guestEmail: 'expert@company.com',
  scheduledAt: '2026-02-15T14:00:00Z'
});

console.log('Interview scheduled:', interview.joinUrl);
Authentication

Secure access to the Mato API.

The Mato API supports multiple authentication methods to fit your integration needs. All API requests require authentication and are encrypted using TLS 1.3.

API Keys

Simple bearer token authentication for server-to-server integrations. Generate keys in your dashboard.

OAuth 2.0

Full OAuth 2.0 flow for applications acting on behalf of users. Supports authorization code and client credentials grants.

Scopes & Permissions

Fine-grained access control with scopes for episodes, hosts, publishing, analytics, and webhooks.

Example Request
# Using API Key
curl https://api.heymato.com/v1/episodes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

# Response
{
  "data": [
    {
      "id": "ep_8x7k2m...",
      "title": "AI in Healthcare",
      "status": "published",
      "duration": "15:42",
      "created_at": "2026-02-04"
    }
  ],
  "has_more": true
}
Endpoints

Complete API reference.

RESTful endpoints for every aspect of podcast creation, management, and distribution. All endpoints return JSON and support pagination.

POST / GET

Episodes API

Create, retrieve, update, and delete podcast episodes. Supports both AI-generated content and live interview scheduling.

EndpointsPOST /v1/episodesGET /v1/episodes/:idPATCH /v1/episodes/:id
GET / POST

Hosts API

Browse available AI hosts, configure personalities, customize voice profiles, and manage host assignments.

EndpointsGET /v1/hostsGET /v1/hosts/:idPOST /v1/hosts/customize
POST

Publishing API

Distribute episodes to major platforms including Spotify, Apple Podcasts, YouTube, and custom RSS feeds.

EndpointsPOST /v1/publishGET /v1/publish/status/:idGET /v1/destinations
GET

Analytics API

Access detailed performance metrics, listener demographics, engagement data, and trend analysis.

EndpointsGET /v1/analytics/episodes/:idGET /v1/analytics/shows/:idGET /v1/analytics/audience
WEBHOOK

Webhooks

Receive real-time notifications for episode completion, publishing status, interview events, and more.

Eventsepisode.createdepisode.publishedinterview.completed
SDKs & Libraries

Build faster with official SDKs.

Official client libraries for popular languages and frameworks. Fully typed, well-documented, and regularly updated.

JS

JavaScript / Node.js

Full-featured SDK with TypeScript support. Works in Node.js, Deno, and browser environments.

npm install @mato/sdk
PY

Python

Async-first Python client with Pydantic models. Compatible with Python 3.8+ and popular frameworks.

pip install mato-sdk
API

REST API

Direct HTTP access for any language or platform. OpenAPI specification available for code generation.

api.heymato.com/v1
Rate Limits & Usage

Built for scale.

Generous rate limits that grow with your needs. Real-time usage tracking in your dashboard with alerts before you hit limits.

PlanRequests/minEpisodes/monthConcurrent Jobs
Business100505
Network50020020
EnterpriseUnlimitedUnlimitedCustom

Ready to integrate?

Access full API documentation, code examples, and integration guides in our developer portal.

Start building with Mato.

Get your API keys today and create your first AI-hosted podcast episode. Full documentation and developer support included with all plans.