Authenticate

To start the process, the user must send a POST request to obtain a token.https://console.primis.tech/api/v1/credentials/authenticate (POST).

Process:

1. The user will send the POST request
2. The user will send 2 param keys with as form-data (both required)
   1. userName - users table, field=userName
   2. apiCode - users table, field=apiCode
3. If the userName and the apiCode is valid, the user will get a token with TTL of 2 months
4. This new token will be attached to every (POST) request

Get User Videos

Will return the list of your available video/s according to the filters applied - https://console.primis.tech/api/v1/videos/getVideos (POST)

Available response Fields Names:

• videoId
• videoTitle
• description
• width
• height
• duration
• thumbnailUrl
• orientation
• clickUrl
• language
• pubDate
• keyWords
• category
• guid
• scope
• channelId
• beginTime
• endTime
• iabCategories
• videoEmbedId
• videoPreviewUrl - specific page with a player (get embed code from request)

Optional filters

Filters example

To obtain all videos in English that contain the keyword "dog", the following filters should be applied: {“category”: “dog”, ”language”: “en”}

Upload a Video

Step 1: Create Video Upload

Initializes an upload session and accepts video metadata.

Endpoint

POST https://uploads.primis.tech/api/v1/platform/channel/createVideoUpload

Headers

Content-Type: application/json
Authorization: Bearer

Example Request

{

"title": "Sample Video",
"description": "A descriptive summary of the video content.",
"duration": 120,

"publishStartDate": "2025-05-25 12:00:00",
"publishEndDate": "2025-06-01 12:00:00",
"keywords": "sports,highlights,2025",
"language": "en",
"custom_params": {},
"guid": "VE-abc1234567"
}

Minimal Example

{
"title": "Sample Video"
}

Response

{
"errorCode": 0,
"errorMsg": "No error",
"status": true,
"data": {
"uploadId": "uplembed1jhxnoikvgwq"
}
}

Body Parameters:

Request Parameters

Step 2: Upload Video Media

Uploads the actual video file. This step must be called once per upload and finalizes the session.

Endpoint

POST https://uploads.primis.tech/api/v1/platform/channel/videoUploadMedia

Headers

Content-Type: multipart/form-data
Authorization: Bearer

Form Data

Example

curl --location 'https://uploads.primis.tech/api/v1/platform/channel/videoUploadMedia'
--header 'Authorization: Bearer '
--header 'Accept: application/json'
--form 'videoFile=@/your/path/test.mp4;type=video/mp4'
--form 'uploadId="uplembed1jhxnoikvgwq"'

Success Response

{
"errorCode": 0,
"errorMsg": "No error",
"status": true,
"data": {
"uploadId": "uplembed1jhxnoikvgwq",
"videoId": "vid12345abc"
}
}

Failure Example

{
"errorCode": 454,
"errorMsg": "Data Is Not Ready",
"details": "Upload is closed, create a new one",
"status": false,
"data": ""
}

Upload Flow Summary

1. Authenticate – Get your JWT Bearer token.
2. Create Upload – Send metadata and receive uploadId.
3. Upload Media – Use the uploadId to upload the video file.
4. Done – Get a videoId in the final response

Get User Playlist

Will return the list of your available playlist/s according to the filters applied -https://console.primis.tech/api/v1/playlists/getPlaylists (POST)

Available response Fields Names:

• playlistId
• playlistName
• playlistLength
• extrenalContextualMathcing(Yes/No)
• orientation
• categories
• includeKeyWords
• excludeKeyWords
• languages
• playlistEmbedId

📘

The API won’t display playlists with contextual matching.

Optional filters

Filters specification

• All filter types assigned with “AND” logic
• Inactive/deleted playlists are filtered out as default
• There is no meaning to the filters parameters when a playlist id is specified

Filters example

To obtain all playlists that exclude the keyword "cars" with orientation "horizontal", the following filters should be applied: {“excludeKeyWords”: “cars”,”orientation”: “horizontal”}

Get User Channels

Will return the list of your available Channel/s according to the filters applied -https://console.primis.tech/api/v1/channels/getChannels (POST)

Available response Fields Names:

• channelId
• channelName
• scope
• categorykeyWords
• sourceUrl
• videoSourceType
• applicableForContexualMatching
• language
• captions
• pubDate
• orientationContributorName
• domainsFilter
• geosFilter
• duration
• totalVideos
• lastModifiedDate
• views
• geosList

Optional filters

Filters specification:

• All filter types assigned with “AND” logic
• Inactive/deleted channels are filtered out as default

Filters example

In order to obtain all channels containing the keywords "food" with orientation "mixed", the following filters should be applied: {“includeKeyWords”: “food”,”orientation”: “mixed”}