Search from public video sources

Using a natural language query, this API searches through videos in a AI manner from public video platforms such as TikTok (Youtube, Instagram are comming). Memories.ai indexed these vidoes for you and you can search and chat with them!

Searching from BY_AUDIO, BY_VIDEO and BY_CLIP are supported and the most relevant clips will be retrieved from the video.

---

Prerequisites

• You have created a memories.ai API key.
• At least one video has been uploaded to memories.ai and is currently in PARSE status.

---

Host URL

• https://api.memories.ai

Endpoint

POST /serve/api/v1/search_public

---

Request Example

import requests

headers = {"Authorization": "<API_KEY>"}  # API key
json_body = {
    "search_param": "<YOUR_PROMPT>",  # The search query
    "search_type": "BY_VIDEO" # 'BY_AUDIO' or 'BY_VIDEO' or 'BY_CLIP'
}

response = requests.post(
    "https://api.memories.ai/serve/api/v1/search_public",
    headers=headers,
    json=json_body
)

print(response.json())

Replace API_KEY in the code above with your actual API key and YOUR_PROMPT with your search query. You can search for relevant videos you've uploaded using natural language.

Request Body

{
  "search_param": "Find sprint race with Usain Bolt",
  "unique_id": "1",
  "search_type": "BY_VIDEO"
}

Request Parameters

Name	Location	Type	Required	Description
Authorization	header	string	Yes	API key used for authorization
search_param	body	string	Yes	Natural language search query
search_type	body	string	Yes	BY_AUDIO search by audio; BY_VIDEO search by video and return video numbers; BY_CLIP search by video and return exact clips

Response Example

Status code 200

{
  "code": "0000",
  "msg": "success",
  "data": [
    {
      "videoNo": "PI-594031499251159058",
      "videoName": "Just listen… 🌧️🔩👟😮\u200d💨😅 \nFollow for more classic ⚽️ vibes 🤙 \n\n#football #soccer #asmr #football",
      "startTime": "null",
      "endTime": "null"
    },
    {
      //...
    }
  ]
}

Response Result

Status code	Status code msg	Description	Data
200	OK	Request was successful	Inline

Response Structure

Status code 200

Name	Type	Required	Restriction	Description
code	string	true	none	response code
msg	string	true	none	message with response code
data	object	true	none	JSON data
» videoNo	string	true	none	video number
» videoName	string	true	none	video name
» startTime	string	false	none	end timestamp status
» endTime	string	false	none	start timestamp(ms)