What does the Best Pages API return?

How many of a domain's pages rank in TOP-1, TOP-3, TOP-10, TOP-30, TOP-50 and TOP-100 by date, the full list of best-ranking pages with their positions, and TOP counts for specific pages you pass in.

Is there a free Best Pages API tier?

Yes. Every account includes 20 free API requests per day; afterwards it is plans or pay-as-you-go at 0.002 USD per request.

Best Pages API

CHÚ Ý!
Bạn có 20 yêu cầu miễn phí mỗi ngày cho mọi API của chúng tôi!

Danh sách các từ khóa mà bạn có thể dùng để thử nghiệm API miễn phí - [test, apple, samsung, nokia]

Kwinside Best Pages API là gì?

Kwinside Best Pages API trả về các trang xếp hạng tốt nhất của một tên miền và số lượng theo nhóm TOP (TOP-1, TOP-3, TOP-10, TOP-50, TOP-100) cho một ngày nhất định. Nó có ba endpoint trong /api/v1/serp/best-pages/*: số lượng TOP theo ngày, danh sách đầy đủ các trang xếp hạng tốt nhất và số lượng TOP cho các trang cụ thể. Dữ liệu bao gồm sáu ngôn ngữ và được truy vấn qua REST, xác thực bằng API key của bạn. Giá tính theo lượt dùng ở mức $0.002 mỗi yêu cầu hoặc gói hằng tháng, với 20 yêu cầu miễn phí mỗi ngày để dùng thử. Hãy dùng nó để tìm các URL mạnh nhất của đối thủ, theo dõi trang nào tăng hay giảm thứ hạng, hoặc ưu tiên việc kiểm tra nội dung.

Cập nhật lần cuối: Tháng 6 năm 2026

Best Pages API có ba endpoint: số lượng TOP-100 theo ngày cho một tên miền, danh sách đầy đủ các trang xếp hạng tốt nhất và số lượng TOP cho các trang cụ thể.

1. Số lượng TOP theo ngày

GET /api/v1/serp/best-pages/tops

API này được dùng có có được số từ khoá trong TOP-1, TOP-3, TOP-10, TOP-30, TOP-50, và TOP-100 cho những trang tốt nhất của website được chọn sẵn và công cụ tìm kiếm tính đến quãng thời gian được chỉ định.

Miêu tả tham số:

Tham số	bắt buộc	Miêu tả
site	bắt buộc	tên miền
se	bắt buộc	ID công cụ tìm kiếm
dates	bắt buộc	ngày cách nhau bằng dấu phẩy: 2019-09-02,2019-09-09
key	bắt buộc	một khoá API mà bạn có thể có trong tài khoản của mình

Mẫu của một yêu cầu URI:

</>GET

1https://kwinside.com/api/v1/serp/best-pages/tops?site=google.com&se=1&dates=2026-10-01,2026-10-31&key=example

Phản hồi:

{ }200 · JSON

{
  "credits_info": {
    "credits_used": 1,
    "credits_remaining": 19
  },
  "data": [
    {
      "date": "2026-10-01",
      "top1": 34321,
      "top3": 46887,
      "top10": 64820,
      "top30": 97453,
      "top50": 121823,
      "top100": 157612
    },
    {
      "date": "2026-10-31",
      "top1": 34403,
      "top3": 47009,
      "top10": 65224,
      "top30": 97859,
      "top50": 122232,
      "top100": 158027
    }
  ]
}

2. Danh sách trang xếp hạng tốt nhất

GET /api/v1/serp/best-pages/list

API này được dùng để nhận danh sách những trang tốt nhất của một tên miền cụ thể đối với công cụ tìm kiếm và quãng thời gian theo yêu cầu.

Miêu tả tham số:

Tham số	bắt buộc	Miêu tả
site	bắt buộc	tên miền
se	bắt buộc	ID công cụ tìm kiếm
dates	bắt buộc	ngày cách nhau bằng dấu phẩy: 2019-09-02,2019-09-09
sort_date	bắt buộc	sắp xếp ngày, ví dụ: 2020-05-05
size, offset	—	dùng những tham số này để đặt con số chính xác cho lượng từ khoá phản hồi và phân trang
top_filter	—	giá trị khả dụng: 1, 3, 10, 30, 50, 100 (giá trị mặc định : 100)
sort_type	—	giá trị khả dụng: asc, desc (giá trị mặc định: desc)
pos_filter	—	giá trị khả dụng: all, not_positions, changed, not_changed, moved_up, moved_down, entered, dropped, all_filter
page_filter, page_filter_type	—	trang bộ lọc (giá trị khả dụng: match)
key	bắt buộc	một khoá API mà bạn có thể có trong tài khoản của mình

Mẫu của một yêu cầu URI:

</>GET

1https://kwinside.com/api/v1/serp/best-pages/list?site=google.com&se=1&dates=2026-10-01,2026-10-31&sort_date=2026-10-31&size=5&top_filter=100&sort_type=desc&pos_filter=all&key=example

Phản hồi:

{ }200 · JSON

{
  "credits_info": {
    "credits_used": 1,
    "credits_remaining": 19
  },
  "data": {
    "total": 158027,
    "result": [
      {
        "page": "support%2Fanswer%2F1386831",
        "data": [
          { "date": "2026-10-01", "count": 39163 },
          { "date": "2026-10-31", "count": 39163 }
        ]
      },
      {
        "page": "",
        "data": [
          { "date": "2026-10-01", "count": 15494 },
          { "date": "2026-10-31", "count": 15491 }
        ]
      }
    ],
    "sub": 0
  }
}

Trả về mỗi trang xếp hạng tốt nhất kèm vị trí SERP của nó cho các ngày và bộ lọc đã cho (phân trang bằng size / offset).

3. Số lượng TOP cho trang cụ thể

POST /api/v1/serp/best-pages/tops_by_pages

API này được dùng để có được số trang tốt nhất trong TOP-1, TOP-3, TOP-10, TOP-30, TOP-50, and TOP-100 cho website định trước cùng danh sách các trang ở website đó đối với quãng thời gian và công cụ tìm kiếm được chỉ định.

Miêu tả tham số:

Tham số	bắt buộc	Miêu tả
site	bắt buộc	tên miền
se	bắt buộc	ID công cụ tìm kiếm
dates	—	ngày cách nhau bằng dấu phẩy: 2019-09-02,2019-09-09
top_filter	—	giá trị khả dụng: 1, 3, 10, 30, 50, 100 (giá trị mặc định : 100)
pages[]	bắt buộc	trang, array[string]
key	bắt buộc	một khoá API mà bạn có thể có trong tài khoản của mình

Mẫu của một yêu cầu URI:

</>POST

1https://kwinside.com/api/v1/serp/best-pages/tops_by_pages?site=google.com&se=1&dates=2026-10-01,2026-10-31&top_filter=100&pages[]=google.com&key=example

Phản hồi:

{ }200 · JSON

{
  "credits_info": {
    "credits_used": 1,
    "credits_remaining": 19
  },
  "data": []
}

Câu hỏi thường gặp

Best Pages API trả về gì?

Bao nhiêu trang của một tên miền xếp trong TOP-1, TOP-3, TOP-10, TOP-30, TOP-50 và TOP-100 theo ngày, danh sách đầy đủ các trang xếp hạng tốt nhất kèm vị trí của chúng, và số lượng TOP cho các trang cụ thể mà bạn truyền vào.

Có gói miễn phí cho Best Pages API không?

Có — mỗi tài khoản bao gồm 20 yêu cầu miễn phí mỗi ngày; sau đó là gói hoặc trả theo lượt dùng ở mức $0.002 mỗi yêu cầu.

SERP API · Search Engine API · Keyword API · Competitors API