Skip to main content
Client for media operations This client provides methods for interacting with the media endpoints of the X API. It handles authentication, request formatting, and response parsing for all media related operations. zeUpload](/xdks/typescript/reference/classes/MediaClient#initializeupload)

Constructors

constructor

new MediaClient(client): MediaClient Creates a new media client instance

Parameters

NameTypeDescription
clientClientThe main X API client instance

Returns

MediaClient

Defined in

media/client.ts:181

Methods

getAnalytics

getAnalytics(mediaKeys, endTime, startTime, granularity, options?): Promise<MediaAnalytics> Get Media analytics Retrieves analytics data for media.

Parameters

NameTypeDescription
mediaKeysany[]A comma separated list of Media Keys. Up to 100 are allowed in a single request.
endTimestringYYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the end of the time range.
startTimestringYYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the start of the time range.
granularitystringThe granularity for the search counts results.
optionsGetAnalyticsOptions-

Returns

Promise<MediaAnalytics> Promise resolving to the API response

Defined in

media/client.ts:210

initializeUpload

initializeUpload(options?): Promise<MediaUploadResponse> Initialize media upload Initializes a media upload.

Parameters

NameType
optionsInitializeUploadOptions

Returns

Promise<MediaUploadResponse> Promise resolving to the API response

Defined in

media/client.ts:273

createSubtitles

createSubtitles(options?): Promise<SubtitlesCreateResponse> Create Media subtitles Creates subtitles for a specific Media file.

Parameters

NameType
optionsCreateSubtitlesOptions

Returns

Promise<SubtitlesCreateResponse> Promise resolving to the API response

Defined in

media/client.ts:314

deleteSubtitles

deleteSubtitles(options?): Promise<SubtitlesDeleteResponse> Delete Media subtitles Deletes subtitles for a specific Media file.

Parameters

NameType
optionsDeleteSubtitlesOptions

Returns

Promise<SubtitlesDeleteResponse> Promise resolving to the API response

Defined in

media/client.ts:355

createMetadata

createMetadata(options?): Promise<MetadataCreateResponse> Create Media metadata Creates metadata for a Media file.

Parameters

NameType
optionsCreateMetadataOptions

Returns

Promise<MetadataCreateResponse> Promise resolving to the API response

Defined in

media/client.ts:396

getByKey

getByKey(mediaKey, options?): Promise<Get2MediaMediaKeyResponse> Get Media by media key Retrieves details of a specific Media file by its media key.

Parameters

NameTypeDescription
mediaKeystringA single Media Key.
optionsGetByKeyOptions-

Returns

Promise<Get2MediaMediaKeyResponse> Promise resolving to the API response

Defined in

media/client.ts:441

getByKeys

getByKeys(mediaKeys, options?): Promise<Get2MediaResponse> Get Media by media keys Retrieves details of Media files by their media keys.

Parameters

NameTypeDescription
mediaKeysany[]A comma separated list of Media Keys. Up to 100 are allowed in a single request.
optionsGetByKeysOptions-

Returns

Promise<Get2MediaResponse> Promise resolving to the API response

Defined in

media/client.ts:491

finalizeUpload

finalizeUpload(id): Promise<MediaUploadResponse> Finalize Media upload Finalizes a Media upload request.

Parameters

NameTypeDescription
idstringThe media id of the targeted media to finalize.

Returns

Promise<MediaUploadResponse> Promise resolving to the API response

Defined in

media/client.ts:543

getUploadStatus

getUploadStatus(mediaId, options?): Promise<MediaUploadResponse> Get Media upload status Retrieves the status of a Media upload by its ID.

Parameters

NameTypeDescription
mediaIdanyMedia id for the requested media upload status.
optionsGetUploadStatusOptions-

Returns

Promise<MediaUploadResponse> Promise resolving to the API response

Defined in

media/client.ts:581

upload

upload(options?): Promise<MediaUploadResponse> Upload media Uploads a media file for use in posts or other content.

Parameters

NameType
optionsUploadOptions

Returns

Promise<MediaUploadResponse> Promise resolving to the API response

Defined in

media/client.ts:629

appendUpload

appendUpload(id, options?): Promise<MediaUploadAppendResponse> Append Media upload Appends data to a Media upload request.

Parameters

NameTypeDescription
idstringThe media identifier for the media to perform the append operation.
optionsAppendUploadOptions-

Returns

Promise<MediaUploadAppendResponse> Promise resolving to the API response

Defined in

media/client.ts:672