Skip to main content
POST
/
serve
/
api
/
v1
/
scraper_tag
Upload Video from Hashtag
curl --request POST \
  --url https://api.memories.ai/serve/api/v1/scraper_tag \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "hash_tags": [
    "LVMH"
  ],
  "unique_id": "default",
  "scraper_cnt": 2,
  "callback": "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)
Discover and import recent posts tagged with one or more hashtags into your Private Video Library. Currently supported on TikTok (YouTube, Instagram, and others coming soon). Related: Import from Hashtag — Public · Import from Post URLs · Import from Creator Profile. Provide hashtag terms as plain strings without the # prefix.

​
Prerequisites

​
Request Example

import requests

headers = {"Authorization": "sk-mavi-..."}
payload = {
    "hash_tags": ["LVMH", "Dior"],
    "unique_id": "my-project",
    "scraper_cnt": 5,
    "callback": "https://your.app/callback"
}
response = requests.post(
    "https://api.memories.ai/serve/api/v1/scraper_tag",
    json=payload,
    headers=headers
)
print(response.json())

​
Parameters

​
hash_tags
array
required
List of hashtag terms to crawl. Plain strings without the # prefix (e.g. ["LVMH", "Dior"]).
​
scraper_cnt
integer
Number of most recent posts to ingest per hashtag.
​
unique_id
string
default:"default"
Namespace to group videos in your account.
​
callback
string
URL to receive POST notifications on task and per-video indexing progress. The server also accepts the alias callback_url.

​
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

  • Platform support: TikTok only at this time.
  • Rate limiting: See Rate limits.
  • Billing: Each request deducts credits per ingested post.

Authorizations

​
Authorization
string
header
required

Body

application/json
​
hash_tags
string[]
required
Example:
["LVMH"]
​
unique_id
string
default:default
​
scraper_cnt
integer
default:2
​
callback
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