Machine API for scripts, Claude Code and partners
Your videos are produced elsewhere? Scripts, Claude Code and partner tools deliver them straight into scheduling, with access keys instead of clicking.
- Access keys for scripts and partners, shown once, with fixed rights, revocable at any time
- Deliver a video with its script, have title and description generated by AI, take the next free slot
- Language versions of the same video fill in each other's translations and link to each other in the description
- A fixed date is kept exactly as you set it; the next free slot follows your posting rules
What it is for
If your videos are produced elsewhere (your own renderer, a tool like GoMotion, a script in Claude Code), they should land in Castfold without clicking and go out by your rules. That is what the machine API is for: everything you do in the cockpit, a program can do on your behalf.
Access keys with fixed rights
In the settings, under “Access for scripts and partners”, you create an access key. You give it a name, decide what it may do (view channels, create and edit videos, publish, read key figures) and see it exactly once in plain text. After that Castfold only shows the beginning. A key can be revoked at any time; from then on the script is locked out and your account stays untouched.
What a script can do
- Read all channels: status, language, posting rules, latest figures
- Ask for a channel’s next free publishing slot
- Deliver a video with file, thumbnail, title, script and language, choosing to publish now, at a set time, into the next free slot, or to upload only
- Have title, description and tags generated by AI from the script
- Deliver title and description in further languages along with the video, and change them later
- Group the language versions of the same video, even across several channels
- Publish a waiting video later
- Pull key figures across all channels for a period
The full description with examples is in the app under “Notes for developers”.
Language versions and cross-links
If the same video exists in several languages, you deliver each version as a video of its own with a shared id, on the same channel or on different ones. Castfold brings the versions together: each one gets the title and description of the others as translations, unless you send your own, and the versions link to each other in the description, for example “English: https://youtu.be/…” and “Español: https://youtu.be/…”. Only what viewers can actually open gets linked: public versions or ones that go live at the same time or earlier. If the versions are published days apart, Castfold adds the links to the older videos afterwards, bundled once a day. It is quickest when all versions share the same publishing time: then they link to each other right at the upload. Single videos can be left out of the links. Castfold uses no AI for filling in and linking, so it uses up no translations.
Behaviour you can rely on
Errors come back with a readable explanation. Castfold keeps a fixed date exactly as you set it; the channel’s posting rules decide the next free slot, even when several videos arrive at the same time. At times of high load Castfold moves the upload to the next free slot, and you see the date in scheduling. Without a YouTube connection on the channel the video waits in the channel and is published once the connection is in place.
For partners
Integration partners get access keys with restricted rights and a partner id, so their customers can work with a single “Send to Castfold” button. Details under integration partners.