Video status

GET /api/marketing/videos/{videoId}

Encoding status of the video in Meta (status: processing, ready, error or expired) and the thumbnails Meta generated, which work as video_data.image_url. Thumbnails only appear once the video is ready. ad_account_id is required: it resolves the token and limits the search to the videos of that account, so a video of another account answers 404. The 25 most recent videos of the account are searched, which is plenty to follow an upload (the one just uploaded is the first), but an old video_id with more videos uploaded after it also answers 404. Requires the marketing:read scope.

Authentication

Send your API key in the x-neike-api-key header. Console sessions can use a bearer JWT plus x-neike-client-id instead.

Responses

Status	Description	Schema
200	—	VideoDto

Example

curl -X GET https://api.neike.dev/api/marketing/videos/{videoId} \
  -H "x-neike-api-key: whk_live_…"

VideoDto

Field	Type		Description
id	string	required	Example: "1203450000000000".
title	string	optional	—
status	ready · processing · error · expired	optional	Meta’s status.video_status. Until it is ready the video cannot be used in a creative.
processing_status	string	optional	Processing phase (status.processing_phase.status).
error	string	optional	Reason for the failure when status is error.
thumbnails	VideoThumbnailDto[]	required	Thumbnails generated by Meta. They only come once the video is ready.