Mato just raised pre-seed Read more

Book a demo

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.

View documentationRequest API key

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.

  1. 01Create episodesGenerate podcast episodes programmatically with full control over topics, hosts, and duration.
  2. 02Schedule interviewsBook live AI interviews with guests, manage scheduling, and send automated invitations.
  3. 03Manage AI hostsConfigure host talent profiles, customize voice profiles, and assign hosts to shows.
  4. 04Automate publishingDistribute episodes to Spotify, Apple Podcasts, YouTube, and custom destinations automatically.
  5. 05Access analyticsRetrieve 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.

  1. API keysSimple bearer token authentication for server-to-server integrations. Generate keys in your dashboard.
  2. OAuth 2.0Full OAuth 2.0 flow for applications acting on behalf of users. Supports authorization code and client credentials grants.
  3. Scopes & permissionsFine-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 talent profiles, 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

Developer portal

Ready to integrate?

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

Full documentationDeveloper support

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.

View pricingRequest API access