API v1.0 — Live

Video Analysis API

Tích hợp AI phân tích video vào n8n, Zapier, hoặc bất kỳ hệ thống nào chỉ với 1 API call.

Lấy API Key Technical Docs

3 bước tích hợp

Chỉ mất 2 phút để gọi API phân tích video đầu tiên.

1

Lấy API Key

Profile → API

2

POST Request

Gửi video URL + API key

3

Nhận kết quả

JSON 4 layers phân tích

Base URL

POST https://www.atechdown.store/api/analyze

Xác thực bằng API Key

Mỗi request cần header X-API-Key

Header
X-API-Key: atd_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Thông số kỹ thuật

Rate Limit
10/phút
⏱️
Timeout
~30-60s
🎫
Credit/Req
1 CR
🌐
Platforms
TT · FB · YT
🔄
Modes
Sync · Async
📊
Analysis
4 Layers

Request Body (JSON)

Tham số Kiểu Mô tả
video_url string BẮT BUỘC Link video TikTok, Facebook, YouTube
brand_info string tuỳ chọn Thông tin thương hiệu / sản phẩm
mode string tuỳ chọn sync (mặc định) hoặc async
callback_url string tuỳ chọn Webhook URL khi dùng async mode

Code Examples

cURL
curl -X POST "https://www.atechdown.store/api/analyze" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: atd_your_key_here" \
  -d '{
    "video_url": "https://www.tiktok.com/@user/video/123456",
    "brand_info": "Skincare cho nữ 18-35 tuổi"
  }'
Python
import requests

response = requests.post(
    "https://www.atechdown.store/api/analyze",
    headers={"X-API-Key": "atd_your_key_here"},
    json={
        "video_url": "https://www.tiktok.com/@user/video/123456",
        "brand_info": "Skincare cho nữ 18-35 tuổi"
    }
)
data = response.json()
print(data["data"]["overall_score"])
JavaScript (fetch)
const res = await fetch("https://www.atechdown.store/api/analyze", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "atd_your_key_here"
  },
  body: JSON.stringify({
    video_url: "https://www.tiktok.com/@user/video/123456",
    brand_info: "Skincare cho nữ 18-35 tuổi"
  })
});
const { data } = await res.json();
console.log(data.overall_score, data.layers);
n8n — HTTP Request Node
// Cấu hình HTTP Request node trong n8n:

Method:  POST
URL:     https://www.atechdown.store/api/analyze

Headers:
  X-API-Key: atd_your_key_here

Body (JSON):
{
  "video_url": "{{ $json.video_link }}",
  "brand_info": "Thông tin thương hiệu của bạn",
  "mode": "sync"
}

// Async mode: thêm callback_url và dùng Webhook Trigger node
"mode": "async",
"callback_url": "https://your-n8n.app/webhook/abc"

Response Format

Sync Response (200 OK)
{
  "success": true,
  "analysis_id": "uuid-xxx",
  "platform": "tiktok",
  "credits_remaining": 5,
  "data": {
    "overall_score": 85,
    "viral_potential": "A",
    "layers": {
      "storytelling": { /* Hook, Timeline, Improvements */ },
      "psychology": { /* Insight, Triggers, Techniques */ },
      "audio_visual": { /* Visual style, Sound analysis */ },
      "branding": { /* CTA, Brand integration, ROI */ }
    },
    "platform_optimization": { ... },
    "action_items": ["Cải thiện hook 3s đầu", ...]
  }
}

Mã lỗi

Code Ý nghĩa Giải pháp
401 API key không hợp lệ Kiểm tra key hoặc tạo mới
402 Hết credits Nạp thêm tại Pricing
429 Rate limit (10 req/phút) Chờ 60s rồi thử lại
400 Thiếu video_url Gửi kèm video_url trong body
500 Lỗi AI service Thử lại sau 30s

Tương thích với

🔗
n8n
HTTP Request
Zapier
Webhook
🐍
Python
requests
🟨
JavaScript
fetch / axios
🔵
Make
HTTP Module
📱
Any REST
Client