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

​
Prerequisites

  • You have created a memories.ai API key.
  • The URL must direct to a creator’s profile/main page.

​
Host URL

https://api.memories.ai

​
Endpoints

  • Private Library: POST /serve/api/v1/scraper
  • Public Library: POST /serve/api/v1/scraper_public

​
Request Example (Private Library)

import requests 

headers = {"Authorization": "<API_KEY>"} 
payload = { 
    "username": "https://www.tiktok.com/@cutshall73", 
    "unique_id": "default", 
    "scraper_cnt": 4, 
    "callback_url": "<CALLBACK_URL>"
} 
response = requests.post(
    "https://api.memories.ai/serve/api/v1/scraper", 
    headers=headers, 
    json=payload
) 
print(response.json())

​
Request Parameters

​
username
string
required
Creator profile URL.
​
scraper_cnt
integer
Number of recent posts to ingest.
​
unique_id
string
default:"default"
Unique ID (Private Library only).
​
callback_url
string
Callback URL.

​
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
​
username
string
required
Example:

"https://www.tiktok.com/@cutshall73"

​
unique_id
string
default:default
​
scraper_cnt
integer
default:4
​
callback_url
string<uri>
Example:

"https://your.app/callback"

Response

200 - application/json

Successful response

​
code
Example:

"0000"

​
msg
string
Example:

"success"

​
data
​
success
boolean
Example:

true

​
failed
boolean
Example:

false