Get Task Status

curl --request GET \
  --url https://api.memories.ai/serve/api/v1/get_video_ids_by_task_id \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.memories.ai/serve/api/v1/get_video_ids_by_task_id', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.memories.ai/serve/api/v1/get_video_ids_by_task_id",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.memories.ai/serve/api/v1/get_video_ids_by_task_id"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.memories.ai/serve/api/v1/get_video_ids_by_task_id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "code": "0000",
  "msg": "success",
  "data": {},
  "success": true,
  "failed": false
}

GET

serve

api

get_video_ids_by_task_id

Get Task Status

curl --request GET \
  --url https://api.memories.ai/serve/api/v1/get_video_ids_by_task_id \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.memories.ai/serve/api/v1/get_video_ids_by_task_id', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.memories.ai/serve/api/v1/get_video_ids_by_task_id",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.memories.ai/serve/api/v1/get_video_ids_by_task_id"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.memories.ai/serve/api/v1/get_video_ids_by_task_id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "code": "0000",
  "msg": "success",
  "data": {},
  "success": true,
  "failed": false
}

Product: Visual Search Use case: Upload videos and images, auto-index them, then search by natural language, image, or transcript phrase Host: https://api.memories.ai/serve/api/v1 Auth: Authorization: sk-mavi-... (no Bearer prefix)

Track a batch upload task — the kind where one request expands into multiple videos — and retrieve the video_no of each video the task produced. This endpoint is for tasks that return a taskId, namely Upload from Social Media. Once the task downloads each video, it queues each one for indexing; this endpoint reports the per-video parse status as it progresses.

This endpoint is not for single-file uploads. Upload Video and Upload Image return a videoNo directly — there is no task to track. To poll the indexing status of a single video, call Get Metadata with the video_no instead, or register a callback URL at upload time.

Prerequisites

You have created a memories.ai API key.
You have a taskId from a previous call to Upload from Social Media.

Endpoint

GET /serve/api/v1/get_video_ids_by_task_id

Request Example

import requests

headers = {
    "Authorization": "sk-mavi-..."
}
params = {
    "task_id": "4b2d85ea-8b61-4689-96c3-75d907140242"
}
response = requests.get( 
    "https://api.memories.ai/serve/api/v1/get_video_ids_by_task_id", 
    headers=headers, 
    params=params
)
print("Status:", response.status_code)
print("Task Status Response:", response.json())

The request parameter is named task_id (snake_case), but the upload response returns taskId (camelCase). They refer to the same value — pass the string through as-is.

Request Parameters

string

required

The taskId returned by Upload from Social Media. Pass the string verbatim — the parameter name is snake_case here even though the upload response field is camelCase.

Response Example

{
    "code": "0000",
    "msg": "success",
    "data": {
        "videos": [
            {
                "duration": "17",
                "status": "PARSE",
                "video_no": "VI624126275711397888",
                "video_name": "#football",
                "create_time": "1758262500019",
                "video_url": "https://mavi-resource.openinterx.com/VIabc123....mp4",
                "bucket": "mavi-resource",
                "blob": "VIabc123....mp4"
            },
            {
                "duration": "8",
                "status": "UNPARSE",
                "video_no": "VI624126275900141568",
                "video_name": "Salah",
                "create_time": "1758262500026",
                "video_url": "https://mavi-resource.openinterx.com/VIdef456....mp4",
                "bucket": "mavi-resource",
                "blob": "VIdef456....mp4"
            }
        ]
    },
    "failed": false,
    "success": true
}

Empty data.videos is ambiguous. A successful response with code: "0000" and data.videos: [] covers two cases that the server does not distinguish:

The task is still downloading content from the source platform (videos haven’t been queued yet).
The task_id does not exist or does not belong to this account.

Your polling loop should rely on a separate timeout to give up — there is no error code to detect “wrong task_id”.

Response Fields

string

Business status code. "0000" indicates success. Note that an unknown task_id also returns "0000".

string

Human-readable status message.

array

Per-video status entries produced by the task. Empty until the task has finished downloading each source post.

string

Unique identifier of the derived video. Use this in subsequent operations (search, get_metadata, download, delete).

string

Best-effort name for the derived video — typically the source post’s title, hashtag, or caption.

string

Video duration in seconds, returned as a string.

string

Upload-into-library timestamp in milliseconds since epoch, returned as a string.

string

Processing status for this derived video. One of:

PARSE — Processing complete, video is searchable.
UNPARSE — Queued or being processed.
FAIL — Processing failed (e.g. source URL blocked, DRM-protected, or unsupported format). Common with media-channel YouTube content (NYT Cooking, Bon Appétit, etc.).

string

Hosted CDN URL of the stored video (on mavi-resource.openinterx.com). Suitable as a file_uri for Gemini VLM once status is PARSE.

string

GCS bucket of the original video file. Omitted when the storage location cannot be resolved.

string

GCS blob (object) path of the video file. Use it with bucket at GET /serve/api/v2/download?bucket=&blob= to fetch the file directly.

Authorizations

Authorization

string

header

required

Query Parameters

task_id

string

required

The task ID returned by an upload or scraping request.

Response

200 - application/json

Successful response

code

Example:

"0000"

msg

string

Example:

"success"

data

success

boolean

Example:

true

failed

boolean

Example:

false

Get Started

Index Upload

Search

Library Management

Folder Management

Reference

Get Task Status

Prerequisites

Endpoint

Request Example

Request Parameters

Response Example

Response Fields

Authorizations

Query Parameters

Response

​Prerequisites

​Endpoint

​Request Example

​Request Parameters

​Response Example

​Response Fields

Authorizations

Query Parameters

Response

Prerequisites

Endpoint

Request Example

Request Parameters

Response Example

Response Fields