API báo cáo SEO: tạo báo cáo xếp hạng tên miền

2026-10-08

Một báo cáo xếp hạng tên miền trả lời ba câu hỏi: website hiển thị tốt đến đâu, ai trỏ liên kết về và xu hướng có đang tăng không. Với API báo cáo SEO, bạn dựng nó bằng ba lệnh gọi và một script ngắn thay vì xuất dữ liệu từ dashboard.

Ba lệnh gọi

• GET /api/v1/seo/domains/{domain} trả về tổng quan tên miền với số liệu từ từng nguồn dữ liệu, cùng CMS, web server và bản ghi MX phát hiện được.
• GET /api/v1/seo/domains/{domain}/backlinks trả về tóm tắt backlink.
• GET /api/v1/seo/domains/{domain}/history trả về lịch sử theo tháng; tham số months đặt khoảng thời gian cần xem.

Script báo cáo

Script gọi ba endpoint cho một tên miền và gộp thành một dictionary. Nó cũng đặt cờ incomplete và liệt kê nguồn còn thiếu, để báo cáo có khoảng trống không bị nhầm là báo cáo đầy đủ.

import os
import requests

API = "https://axioapi.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['AXIOAPI_KEY']}", "Accept": "application/json"}


def get(path, **params):
    res = requests.get(f"{API}{path}", headers=HEADERS, params=params, timeout=60)
    res.raise_for_status()
    return res.json()["data"]


def domain_report(domain):
    overview = get(f"/seo/domains/{domain}", country="US")
    backlinks = get(f"/seo/domains/{domain}/backlinks")
    history = get(f"/seo/domains/{domain}/history", months=12)
    return {
        "domain": domain,
        "overview_sources": overview["sources"],
        "cms": overview.get("cms"),
        "backlink_sources": backlinks["sources"],
        "history": history,
        "incomplete": overview["partial"] or backlinks["partial"],
        "missing_sources": sorted(set(overview["missing"]) | set(backlinks["missing"])),
    }


print(domain_report("example.com"))

Biến thành báo cáo định kỳ

Chạy script theo lịch, lưu kết quả kèm ngày và so sánh với lần chạy trước. Kết quả có thể được cache nhiều ngày, nên chạy nhiều hơn một lần mỗi ngày không cho dữ liệu mới mà chỉ tốn yêu cầu.

Audit các trang đứng sau con số

Báo cáo cho biết vị thế của site nhưng không nói lý do. Hãy chạy endpoint audit on-page cho các trang quan trọng để kiểm tra title, meta description, heading, canonical và dữ liệu có cấu trúc trong một lệnh.

Audit chỉ kiểm tra bản thân trang. Việc Google đã index hay chưa là câu hỏi riêng bạn trả lời trong Search Console.