Bỏ qua

Bắt đầu trong 5 phút

Từ liên kết mời tới câu hỏi dữ liệu đầu tiên. Bạn cần: liên kết đặt mật khẩu do Logidata gửi, và một tài khoản Google có quyền quản trị kênh YouTube của bạn.

Hướng dẫn này dùng YouTube làm ví dụ

Mọi nền tảng khác đi qua đúng ba bước đầu — chỉ khác nút cấp quyền ở bước 2 và tên nền tảng trong URL ở bước gọi API. Xem Nền tảng được hỗ trợ.

1. Đặt mật khẩu

Mở liên kết dạng https://portal.logidata.vn/set-password/… trong email/tin nhắn Logidata gửi.

Liên kết dùng một lần, hết hạn sau 48 giờ

Mở xong là liên kết chết. Nếu quá hạn hoặc đã dùng, báo Logidata cấp lại — không có cách tự khôi phục.

Mật khẩu từ 12 ký tự, có cả chữ và số. Đặt xong bạn được đăng nhập luôn.

2. Nối tài khoản nền tảng

Vào Kết nối → chọn nền tảng (ví dụ Cấp quyền YouTube). Đặt một tên gợi nhớ (chỉ để bạn phân biệt, ví dụ "Kênh chính") rồi bấm nút.

Trang cấp quyền của Google mở ở tab mới. Đăng nhập bằng tài khoản quản trị kênh và bấm đồng ý.

Giữ nguyên tab portal

Tab portal tự kiểm tra mỗi 2 giây và sẽ báo "Kết nối thành công" — thường dưới 10 giây sau khi bạn bấm đồng ý.

Xong, portal hiện X-Account-Id của kết nối — một chuỗi dạng ldc_…. Đó là định danh bạn gửi kèm mỗi request. Bạn không cần (và không thể) tự đặt giá trị này.

3. Tạo API key

Vào API key → chọn kết nối vừa tạo → Tạo API key.

Key thật chỉ hiện đúng một lần

Logidata chỉ lưu bản băm SHA-256, không có cách nào xem lại. Copy ngay vào nơi lưu bí mật của bạn (biến môi trường, secret manager). Lỡ mất thì dùng Đổi key để cấp key mới — key cũ chết ngay lập tức.

4. Kết nối AI (MCP, plugin)

Có key rồi, cách nhanh nhất để hỏi dữ liệu là gắn thẳng vào Claude hoặc ChatGPT — không phải viết một dòng client nào.

Kết nối MCP. Vào Customize → Connectors (claude.ai / Claude Desktop) hoặc Cài đặt → Ứng dụng & Trình kết nối (ChatGPT), khai báo địa chỉ https://mcp.logidata.vn/mcp rồi đăng nhập bằng tài khoản Logidata — không cần dán API key. Các bước chi tiết kèm ảnh chụp màn hình: Kết nối AI (MCP).

Plugin (khuyên dùng thêm). Cài 11 kỹ năng phân tích theo nền tảng để trợ lý tự biết hỏi đúng câu, đúng tham số — không cần bạn nhớ tên endpoint: Plugin Claude Code · Plugin Codex / ChatGPT.

Kết nối xong, hỏi thẳng bằng tiếng Việt, ví dụ:

"Kênh YouTube của tôi có bao nhiêu subscriber và lượt xem 7 ngày qua?"

Trợ lý tự chọn endpoint, tự điền tham số và gọi dữ liệu — mỗi lần gọi tính 1 request vào hạn mức tháng như một request thường.

Muốn tự viết code gọi thẳng API?

Nhảy xuống Gọi API trực tiếp bên dưới — dùng cùng hai header xác thực, không qua MCP.

5. Gọi API trực tiếp

Lấy thông tin kênh của bạn:

curl -G "https://api.logidata.vn/v1/youtube/channels" \
     -H "X-API-Key: $LOGIDATA_API_KEY" \
     -H "X-Account-Id: ldc_9fK2xQ..." \
  --data-urlencode "part=snippet,statistics" \
  --data-urlencode "mine=true"

import os, httpx

r = httpx.get(
    "https://api.logidata.vn/v1/youtube/channels",
    params={"part": "snippet,statistics", "mine": "true"},
    headers={
        "X-API-Key": os.environ["LOGIDATA_API_KEY"],
        "X-Account-Id": "ldc_9fK2xQ...",
    },
)
r.raise_for_status()
print(r.json()["items"])

Response là nguyên văn của YouTube:

{
  "kind": "youtube#channelListResponse",
  "items": [
    {
      "id": "UCxxxxxxxxxxxxxxxxxxxxxx",
      "snippet": { "title": "Acme Channel" },
      "statistics": {
        "viewCount": "125034",
        "subscriberCount": "3210",
        "videoCount": "87"
      }
    }
  ]
}

HTTP 2xx không kèm object error nghĩa là thành công

Đây là quy ước của Google, không phải của Logidata — mỗi nền tảng một quy ước khác nhau (TikTok dùng code: 0, Shopee dùng trường error rỗng). Lỗi do Logidata sinh ra thì luôn cùng một hình dạng ở mọi nền tảng — xem Mã lỗi.

6. Kéo báo cáo thật

Không cần tra channel_id trước — Analytics API nhận thẳng channel==MINE:

curl -G "https://api.logidata.vn/v1/youtube-analytics/reports" \
  -H "X-API-Key: $LOGIDATA_API_KEY" \
  -H "X-Account-Id: ldc_9fK2xQ..." \
  --data-urlencode "ids=channel==MINE" \
  --data-urlencode "startDate=2026-08-01" \
  --data-urlencode "endDate=2026-08-07" \
  --data-urlencode "metrics=views,estimatedMinutesWatched,subscribersGained" \
  --data-urlencode "dimensions=day"

Tham số giống hệt tài liệu YouTube Analytics API — chỉ khác base URL và cách xác thực. Đổi metrics sang estimatedRevenue,estimatedAdRevenue,grossRevenue,cpm,playbackBasedCpm để lấy doanh thu kênh (cần kênh đã bật kiếm tiền).

7. Thêm nền tảng thứ hai

Lặp lại bước 2 cho nền tảng khác, rồi đổi một đoạn trong URL:

https://api.logidata.vn/v1/youtube/...         →  kênh YouTube
https://api.logidata.vn/v1/tiktok-ads/...      →  Business Center
https://api.logidata.vn/v1/shopee/...          →  shop Shopee

Header xác thực, mã lỗi, header hạn mức đều giữ nguyên. Xem Nền tảng được hỗ trợ để biết tên nền tảng trong URL.

Tiếp theo