API Documentation, Generate trend videos and publish them to an authorized YouTube channel.

API : Generate trend videos and publish them to an authorized YouTube channel.

This API is simple to use. You just have to follow these steps

Create a free account
Click on the link you receive by email to confirm your address
Generate a token with credentials

You can use any language to make this CURL call. (Python, PHP, Java, JavaScript...) Need help ?

curl --location --request POST 'https://mxprocess.com/api/login_check' \
                                        --header 'Content-Type: application/json' \
                                        --data-raw '{"username":"YOUR_LOGIN","password":"YOUR_PASSWORD"}'

If your credentials are correct, our server will provide you with a token as a response :

{"token": "YOUR_TOKEN","refresh_token": "YOUR_REFRESH_TOKEN"}

YOUR_TOKEN is valid for one hour, its duration can be extended using YOUR_REFRESH_TOKEN

Use the token to start the process

Action parameters

Send parameters as a JSON object. Required fields are marked with required.

country — string; required; maximum 2 characters.
periodHours — enum:24,48,72; required.
maxVideos — integer; required; minimum 1; maximum 4.
excludeSport — boolean.
language — string; maximum 80 characters.
imageSource — enum:ai,wikimedia_commons.
maxScriptDuration — integer; minimum 15; maximum 60.
privacyStatus — enum:private,unlisted,public.
imageInstructions — string; maximum 500 characters.
facebookPageId — string; maximum 128 characters.
facebookPublishMode — enum:video,youtube_link,text_only,double.
voiceName — string; maximum 120 characters.
categoryId — enum:1,2,10,15,17,19,20,22,23,24,25,26,27,28.
watermarkText — string; maximum 80 characters.
hideHumanFaces — boolean.
specificTopic — string; maximum 200 characters.
source — enum:google_trends,children_story,specific_topic.
specificTopicCategory — enum:automobile,nutrition,fitness,weight_loss_women,personal_finance,youtube,tiktok,entrepreneurship,technology,artificial_intelligence,home_garden,cooking,travel,beauty,fashion,parenting,pets,relationships,career,education,language_learning,history,science,nature,entertainment,gaming,crime.
chooseRandomTopic — boolean.
youtubeConnectionId — integer.
tiktokConnectionIds — integer; minimum 1.

curl --location 'https://mxprocess.com/api/files/start-process' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--form 'file=@"/FILE_PATH/FILE_NAME"' \
--form 'actionName="AutomatedShortsPublisher"' \
--form 'parameters={"country":"US","periodHours":"24","maxVideos":1,"excludeSport":false,"language":"English","imageSource":"ai","maxScriptDuration":15,"privacyStatus":"private","imageInstructions":"example","facebookPageId":"example","facebookPublishMode":"video","voiceName":"example","categoryId":"1","watermarkText":"example","hideHumanFaces":false,"specificTopic":"example","source":"google_trends","specificTopicCategory":"automobile","chooseRandomTopic":false,"youtubeConnectionId":1,"tiktokConnectionIds":1}' \
--form 'async="false"' \
--form 'fileUrl=""' \
--form 'fileContent=""'

If your file is accessible by URL, you can ignore the "file=@.." field and directly use the URL of your file in the "fileUrl" field

The API sends a JSON response to confirm that the process is finished. Download the generated files with the authenticated URLs in actionResultsDownloadURLs.


{
    "actionResultsDownloadURLs": [
        "https://mxprocess.com/api/actions/download-result/1016/a62be5bf2ad15dc82940bcddbe3f000c.mp3.mp3/YOUR_TOKEN"
    ],
    "id": 1016,
    "actionParameters": [],
    "dateOfDemand": "2024-02-07T20:51:42+00:00",
    "startTime": "2024-02-07T20:51:46+01:00",
    "endTime": "2024-02-07T20:51:46+01:00",
    "hostedFileIds": [
        {
            "fileId": 1025,
            "parameters": ""
        }
    ],
    "action": {
        "actionName": "AutomatedShortsPublisher",
        "slug": "automated-shorts-publisher",
        "jsonRequestSample": null,
        "jsonResponseSample": null,
        "specificDeveloperRequestDocumentation": null,
        "specificDeveloperResponseDocumentation": null,
        "longDescription": null
    },
    "user": [],
    "accomplished": true,
    "userIsNotifiedByEmail": "off",
    "userIsNotifiedByPostQuery": "off",
    "actionResults": [
        [
            "a62be5bf2ad15dc82940bcddbe3f000c.mp3.mp3",
            "https://mxprocessfiles.s3.eu-west-1.amazonaws.com/AudioToGPT/1016/a62be5bf2ad15dc82940bcddbe3f000c.mp3.mp3"
        ]
    ],
    "priceInTokensAtTimeOfUse": 15,
    "retryCount": 0,
    "executionPlannedAt": null,
    "trackingUrl": ""
}

This documentation is not clear? (Python, PHP, Java, JavaScript...) Need help ?