Automated Shorts Publisher API

Asynchronous API: Automated Shorts Publisher

Create up to four short videos from recent news trends in a country and publish them to the authenticated user's connected YouTube channel. A YouTube channel must be connected before starting the action.

Endpoint: POST https://mxprocess.com/api/files/start-process
Authentication: Bearer JWT from POST /api/login_check
Execution: asynchronous; use the returned trackingUrl to follow progress.

Request parameters

country — required two-letter country code, for example US.
periodHours — required period to analyse: 24, 48 or 72.
maxVideos — required number of videos, from 1 to 4. The token price is calculated from this number.
excludeSport — optional boolean; defaults to true and excludes sports trends.
language — optional narration and script language; defaults to English.
imageSource — optional: wikimedia_commons (default) uses images found for explicitly named people; ai generates the visuals instead. When no named person or suitable Commons image is found, the service automatically uses generated visuals.
maxScriptDuration — optional maximum duration in seconds, from 15 to 60; defaults to 45.
watermarkText — optional text displayed in white in the top-right corner of every generated video (maximum 80 characters).
privacyStatus — optional YouTube visibility: private, unlisted or public; defaults to private.

Start a one-time run

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--form 'actionName=AutomatedShortsPublisher' \
--form 'fileContent=automated-shorts-publisher' \
--form 'parameters={"country":"US","periodHours":24,"maxVideos":4,"language":"English","maxScriptDuration":45,"privacyStatus":"private"}' \
--form 'async=true'

Schedule recurring publications

Add isCronJob=1 and a valid cronExpression. The expression 10 * * * * runs at the tenth minute of every hour. Schedules more frequent than hourly are rejected.

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--form 'actionName=AutomatedShortsPublisher' \
--form 'fileContent=automated-shorts-publisher' \
--form 'parameters={"country":"FR","periodHours":24,"maxVideos":4,"language":"French","maxScriptDuration":45,"privacyStatus":"private"}' \
--form 'isCronJob=1' \
--form 'cronExpression=10 * * * *' \
--form 'async=true'

Track and download results

A successful start returns an action identifier and trackingUrl. Poll that URL with the same Bearer token. When accomplished is true, download the MP4 files, their normalized MP3 narrations, every OpenAI-generated scene image, the generated trend scripts and the publication manifest from actionResultsDownloadURLs.

curl --location 'https://mxprocess.com/api/actions/get-action-infos/ACTION_ID' \
--header 'Authorization: Bearer YOUR_TOKEN'

Each run uses current trends and available news evidence. Review generated content and publication details before selecting public visibility.

Open the service