Best Pages API

Q: 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.

ATTENTION!
You have 20 free requests per day for all kinds of our APIs!

The list of keywords that you can use for a free API test-run - [test, apple, samsung, nokia]

What is the Kwinside Best Pages API?

The Kwinside Best Pages API returns a domain's best-ranking pages and its TOP-bucket counts (TOP-1, TOP-3, TOP-10, TOP-50, TOP-100) for a given date. It has three endpoints under /api/v1/serp/best-pages/*: TOP counts per date, the full list of best-ranking pages, and TOP counts for specific pages. Data covers six languages and is queried over REST, authenticated with your API key. Pricing is pay-as-you-go at $0.002 per request or a monthly plan, with 20 free requests per day for testing. Use it to find a competitor's strongest URLs, track which pages gain or lose rankings, or prioritise content audits.

Last updated: June 2026

The Best Pages API has three endpoints: TOP-100 counts per date for a domain, the full list of best-ranking pages, and TOP counts for specific pages.

1. TOP counts by date

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

This API is used to get the number of keywords in TOP-1, TOP-3, TOP-10, TOP-30, TOP-50, and TOP-100 for the best pages of the given site and search engine as of the specified date range.

Parameters description:

Parameters	required	Description
site	required	domain name
se	required	search engine ID
dates	required	comma-separated dates: 2019-09-02,2019-09-09
key	required	an API key that you can get in your account

Sample of a URI request:

</>GET

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

Response:

{ }200 · JSON

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

2. List of best-ranking pages

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

This API is used to get a list of the best pages of a particular domain for the required search engine and date range.

Parameters description:

Parameters	required	Description
site	required	domain name
se	required	search engine ID
dates	required	comma-separated dates: 2019-09-02,2019-09-09
sort_date	required	sort date, e.g.: 2020-05-05
size, offset	—	use these parameters to set the exact count of keywords in response and pagination
top_filter	—	available values : 1, 3, 10, 30, 50, 100 (default value : 100)
sort_type	—	available values: asc, desc (default value: desc)
pos_filter	—	available values: all, not_positions, changed, not_changed, moved_up, moved_down, entered, dropped, all_filter
page_filter, page_filter_type	—	filter page (available values: match)
key	required	an API key that you can get in your account

Sample of a URI request:

</>GET

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

Response:

{ }200 · JSON

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

Returns each best-ranking page with its SERP position for the given dates and filters (paginated with size / offset).

3. TOP counts for specific pages

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

This API is used to get the number of the best pages in TOP-1, TOP-3, TOP-10, TOP-30, TOP-50, and TOP-100 for the given site and its list of pages for the specified date range and search engine.

Parameters description:

Parameters	required	Description
site	required	domain name
se	required	search engine ID
dates	—	comma-separated dates: 2019-09-02,2019-09-09
top_filter	—	available values : 1, 3, 10, 30, 50, 100 (default value : 100)
pages[]	required	pages, array[string]
key	required	an API key that you can get in your account

Sample of a URI request:

</>POST

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

Response:

{ }200 · JSON

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

Frequently asked questions

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 per request.

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