Skip to main content
POST
/
serve
/
api
/
v1
/
scraper_url
Upload Video from Platform URL
curl --request POST \
  --url https://api.memories.ai/serve/api/v1/scraper_url \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_urls": [
    "https://www.tiktok.com/@cutshall73/video/7543017294226558221"
  ],
  "unique_id": "default",
  "callback_url": "https://your.app/callback",
  "quality": 720
}
'
{
  "code": "0000",
  "msg": "success",
  "data": {},
  "success": true,
  "failed": false
}

​
Prerequisites

  • You have created a memories.ai API key.
  • The URL must be a proper link to a video post page.

​
Host URL

https://api.memories.ai

​
Endpoints

  • Private Library: POST /serve/api/v1/scraper_url
  • Public Library: POST /serve/api/v1/scraper_url_public

​
Request Example (Private Library)

import requests 

headers = {"Authorization": "<API_KEY>"} 
payload = { 
    "video_urls": [
        "https://www.tiktok.com/@cutshall73/video/7543017294226558221",
        "https://www.tiktok.com/@abcnews/video/7543794552365124919"
    ], 
    "unique_id": "default", 
    "callback_url": "<CALLBACK_URL>", 
    "quality": 1080
} 
response = requests.post( 
    "https://api.memories.ai/serve/api/v1/scraper_url", 
    json=payload, 
    headers=headers 
) 
print(response.json())

​
Callback Notification Payload

Memories.ai sends notifications when:
  1. The scraping task finishes (download complete).
  2. Each video is successfully indexed.
// Task Succeeded
{ "message": "Video has been downloaded...", "taskId": "...", "status": "SUCCEEDED"}

// Indexing Succeeded
{ "videoId": "VI...", "message": "Video indexing succeed", "taskId": "...", "status": "INDEXING_SUCCEEDED"}

​
Request Parameters

​
video_urls
array
required
List of platform video URLs.
​
unique_id
string
default:"default"
Unique ID (Private Library only).
​
callback_url
string
Callback URL for notifications.
​
quality
integer
default:"720"
Target resolution (<= 1080).

​
Response Example

{ 
    "code": "0000", 
    "msg": "success", 
    "data": { 
        "taskId": "31b0fccb-d6f9-4135-922d-1e8828499812" 
    }, 
    "failed": false, 
    "success": true
}

Authorizations

​
Authorization
string
header
required

Body

application/json
​
video_urls
string<uri>[]
required
Example:
[
  "https://www.tiktok.com/@cutshall73/video/7543017294226558221"
]
​
unique_id
string
default:default
​
callback_url
string<uri>
Example:

"https://your.app/callback"

​
quality
integer
default:720
Required range: x <= 1080

Response

200 - application/json

Successful response

​
code
Example:

"0000"

​
msg
string
Example:

"success"

​
data
​
success
boolean
Example:

true

​
failed
boolean
Example:

false