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
}

Documentation Index

Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt

Use this file to discover all available pages before exploring further.

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)
Scrape the most recent N videos from any TikTok, YouTube, or Instagram creator profile into your Private Video Library. Related: Import from Creator Profile — Public · Import from Post URLs · Import from Hashtag. Example profile URLs: 
TikTok:    https://www.tiktok.com/@cutshall73
YouTube:   https://www.youtube.com/@mkbhd
Instagram: https://www.instagram.com/nike/

​
Prerequisites

​
Request Example

import requests

headers = {"Authorization": "sk-mavi-..."}
payload = {
    "username": "https://www.tiktok.com/@cutshall73",
    "unique_id": "my-project",
    "scraper_cnt": 10,
    "callback_url": "https://your.app/callback"
}
response = requests.post(
    "https://api.memories.ai/serve/api/v1/scraper",
    json=payload,
    headers=headers
)
print(response.json())

​
Parameters

​
username
string
required
Full URL of the creator’s profile page (e.g. https://www.tiktok.com/@cutshall73).
​
scraper_cnt
integer
Number of most recent posts to ingest from the creator’s feed.
​
unique_id
string
default:"default"
Namespace to group videos in your account.
​
callback_url
string
URL to receive POST notifications on task and per-video indexing progress. Alias callback is also accepted.

​
Response Example

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

​
Response Fields

​
code
string
Business status code. 0000 indicates success.
​
msg
string
Human-readable status message.
​
data.taskId
string
Unique identifier for the import task. Use with Get Task Status.

​
Notes & Limits

  • Rate limiting: See Rate limits.
  • Billing: Each request deducts credits. YouTube consumes additional credits.
  • YouTube: Indexing may be slower than TikTok or Instagram due to scraper capacity.

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