Skip to main content
GET
/
serve
/
api
/
v1
/
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>'
{
  "code": "0000",
  "msg": "success",
  "data": {},
  "success": true,
  "failed": false
}

​
Prerequisites

  • You have a valid memories.ai API key.
  • You have a task_id from a previous async upload operation.

​
Host URL

https://api.memories.ai

​
Endpoint

GET /serve/api/v1/get_video_ids_by_task_id 
/serve/api/v1/get_video_ids_by_task_id

​
Request Example

import requests

headers = {
    "Authorization": "<API_KEY>"
}
params = { 
    "task_id": "4b2d85ea-8b61-4689-96c3-75d907140242", 
    "unique_id": "1"
}
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())

​
Request Parameters

​
task_id
string
required
The task ID returned by the upload API.
​
unique_id
string
Unique identifier scope. Defaults to “default”.

​
Response Example

{ 
    "code": "0000", 
    "msg": "success", 
    "data": { 
        "videos": [ 
            { 
                "duration": "17", 
                "status": "PARSE", 
                "video_no": "VI624126275711397888", 
                "video_name": "#football", 
                "create_time": "1758262500019", 
                "video_url": "https://test.com/test" 
            }, 
            { 
                "duration": "8", 
                "status": "UNPARSE", 
                "video_no": "VI624126275900141568", 
                "video_name": "Salah", 
                "create_time": "1758262500026", 
                "video_url": "https://test.com/test" 
            } 
        ] 
    }, 
    "failed": false, 
    "success": true
}

​
Response Structure

The status field indicates:
  • PARSE: Processing complete.
  • UNPARSE: Processing in progress.
  • FAILED: Processing failed.

Authorizations

​
Authorization
string
header
required

Query Parameters

​
task_id
string
required

The task ID returned by an upload or scraping request.

​
unique_id
string
default:default

Unique ID scope.

Response

200 - application/json

Successful response

​
code
Example:

"0000"

​
msg
string
Example:

"success"

​
data
​
success
boolean
Example:

true

​
failed
boolean
Example:

false