Skip to main content
The Plaud API uses a two-step authorization flow to secure requests. This process involves generating an API token using your credentials, then using that token for authenticated requests.
Note:
This documentation site is for SaaS companies that want to integrate directly with Plaud devices and leverage Plaud’s ASR, diarization, and AI pipelines in their own SaaS product. If you are interested in integrating with existing Plaud users’ accounts via the OAuth API (currently in early beta), please fill out this survey here to join the waitlist and we will notify you as soon as it’s available..

​
Client ID & Secret Key

The Plaud API uses Client ID and Secret Key to identify your unique application. Each application has:
  1. Client ID: Your application’s public identifier
  2. Secret Key: A permanent credential used to track usage quota and permissions
Remember that your Secret Key is a secret. Do not share it with others or expose it in any client-side code (browsers, apps).

​
API Token

Before making API requests, you need to generate an API token using your Client ID and Secret Key. The token is obtained by sending base64-encoded credentials in the Authorization header. All token requests should include your credentials in an Authorization HTTP header as follows: 
Authorization: Bearer base64(client_id:secret_key)

​
Making Requests

You can paste the command below into your terminal to run your first API request. Make sure to replace $PLAUD_API_TOKEN with your generated API token. 
curl https://platform.plaud.ai/api/devices/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PLAUD_API_TOKEN"
Example with Python: 
import requests

response = requests.get(
    'https://platform.plaud.ai/api/devices/',
    headers={
        'Authorization': f'Bearer {token}',
        'Content-Type': 'application/json'
    }
)

devices = response.json()