Use the PlayerMagick API with an API key
This article shows you how to create an API key, what a key can and can't do, and how your own scripts, Zapier or Make can read your videos, analytics and sales.
Available on: Pro, Business and Agency plans.
Before you start
- Only the account owner or an admin can create and revoke keys. See Understand team roles.
- A key works in one account. If you run an agency, create one key in each client account that needs one.
- A key works as you, only within the permissions you give it. If you leave the team, or you are no longer an owner or admin, your keys stop working.
Step 1: Create a key
- Go to Settings → API and MCP.
- Under API keys, click Create key.
- Give the key a Name you will recognise later, like
Weekly report scriptorZapier. - Tick only what the key needs:
- See: videos and folders, analytics and A/B results, funnels and their statistics, sales.
- Change: video titles, thumbnails, start, button text and time; folders (create, rename, move videos); start and end A/B tests.
- Personal data: leads (names and emails). Tick this only if the key really needs it.
- Choose when it Expires: in 1 year (the default), 90 days or 30 days.
- Click Create key.
- Copy the key now and keep it somewhere safe, like a password manager. This is the only time PlayerMagick shows it.
Keys start with pmk_. If a key ever ends up somewhere public, revoke it at once (Step 3) and create a new one.
Step 2: Use the key
Send the key with every request, in the Authorization header:
Authorization: Bearer pmk_your_key
The address of the API is https://api.playermagick.com/v1. For example, GET https://api.playermagick.com/v1/videos lists your videos.
The full list of what you can ask for is in the API reference: https://api.playermagick.com/v1/openapi.json. Tools like Postman, Zapier's API request step or Make's HTTP module can read it.
What the API does:
- Read your videos (status, settings in plain words, embed code), folders, analytics, A/B test results, funnels, sales confirmed by your sales platforms and, with permission, your leads.
- Change a short list of safe things: a video's title, folder, thumbnail, how it starts, its start volume, and a text button's text and time; folders; A/B tests.
What it never does:
- Change button or page links.
- Delete anything, upload files or import videos.
- Send emails, webhooks or automations.
Step 3: Revoke a key
- Go to Settings → API and MCP.
- Find the key under API keys and click Revoke.
- Confirm. Anything using the key stops working at once.
A key that expires within 14 days shows its date in amber. Create a new key before it expires and switch your script over.
Limits
Each key can make 120 reads, 30 changes and 30 analytics requests a minute, and an account 300 requests a minute in total. Over a limit, the API answers 429 and tells your script how many seconds to wait.
If a key or a connected app makes more than 50 changes in an hour, the account's owner and admins get an email, so an unexpected script never goes unnoticed.
Troubleshooting
- 401 invalid_key: the key is mistyped, revoked or expired, or the person who made it left the team or is no longer an owner or admin. Create a new key.
- 403 insufficient_scope: the key doesn't have the permission this request needs. Create a key with it.
- 403 plan_feature: the API comes with Pro, Business and Agency.
- 409 version_conflict: the video changed since your script read it. Read the video again and send its new
settings_version.