SERP API

What is the Kwinside SERP API?

The Kwinside SERP API retrieves keyword positions and search-engine rankings, by date, for any domain. Endpoints under /api/v1/serp/keywords/* return the keywords a domain ranks for, how many of its pages sit in TOP-1, TOP-3, TOP-10, TOP-50 and TOP-100, and the competing domains for those keywords. Data spans six languages and is queried over plain REST, authenticated with your API key. Pricing is pay-as-you-go at $0.002 per request or a subscription plan, with free testing at 20 requests per day. Use it to build rank trackers, monitor visibility over time, or pull SERP data into dashboards and reports without manual checking.

Last updated: June 2026

The SERP API returns where a domain ranks — keyword TOP counts by date, the full list of keyword positions, and the keywords competitors rank for. Each call is billed pay-as-you-go at $0.002. (Search engines and best-ranking pages have their own pages — linked below.)

1. Keyword TOP counts by date

GET /api/v1/serp/keywords/tops

This API is used to obtain the number of keywords in TOP-1, TOP-3, TOP-10, TOP-30, TOP-50, and TOP-100 for the required domain and search engine as of the specified date range.

Parameters description:

Parameters required Description
siterequireddomain name
serequiredsearch engine ID
datesrequiredcomma-separated dates: 2019-09-02,2019-09-09
subwith subdomains (available values: 0, 1)
keyrequiredan API key that you can get in your account

Sample of a URI request:

</>GET
1https://kwinside.com/api/v1/serp/keywords/tops?site=google.com&se=1&sub=1&dates=2026-05-29,2026-06-29&key=example

Response:

{ }200 · JSON
{
  "credits_info": {
    "credits_used": 1,
    "credits_remaining": 19
  },
  "data": {
    "total": null,
    "results": {
      "2026-05-29": {
        "top1": 945884,
        "top3": 2278913,
        "top10": 5335579,
        "top20": 10360934,
        "top30": 13912154,
        "top50": 21754806,
        "top100": 48867202,
        "date": "2026-05-29",
        "rank": 100,
        "rank_worldwide": 177
      },
      "2026-06-29": {
        "top1": 966044,
        "top3": 2323443,
        "top10": 5398932,
        "top20": 10424498,
        "top30": 13975718,
        "top50": 21818370,
        "top100": 48930766,
        "date": "2026-06-29",
        "rank": null,
        "rank_worldwide": null
      }
    },
    "sub": 0
  }
}

2. Keyword positions (full list)

GET /api/v1/serp/keywords/list

This API is used to obtain a list of keywords with corresponding positions for the required domain and search engine as of the specified date range.

Parameters description:

Parameters required Description
siterequireddomain name
serequiredsearch engine ID
sort_daterequiredavailable values: asc, desc (default value: desc)
datescomma-separated dates: 2019-09-02,2019-09-09
sort_typeavailable values: asc, desc (default value: desc)
size, offsetuse these parameters to set the exact count of keywords in response and pagination
top_filteravailable values : 1, 3, 10, 30, 50, 100 (default value : 100)
kw_filter_typeavailable values: match
kw_filterfilter keyword
page_filter_typeavailable values: match
page_filterfilter page
sort_byavailable values: pos, kw, py (default value: pos)
pos_filteravailable values: all, not_positions, changed, not_changed, moved_up, moved_down, entered, dropped, all_filter (default: all)
add_nullavailable values: true, false
subwith subdomains (available values: 0, 1)
keyrequiredan API key that you can get in your account

Sample of a URI request:

</>GET
1https://kwinside.com/api/v1/serp/keywords/list?site=google.com&se=1&sort_type=desc&sort_date=1&top_filter=100&sort_by=pos&pos_filter=all&key=example

Response:

{ }200 · JSON
{
  "credits_info": {
    "credits_used": 1,
    "credits_remaining": 19
  },
  "data": {
    "total": 48930766,
    "results": [
      {
        "kw": "city taxis winchester",
        "data": [
          {
            "id": null,
            "page": "websearch?p=ws_settings_location&hl=es-419&opi=89978449",
            "kw": "city taxis winchester",
            "title": null,
            "date": "2026-06-28",
            "pos": 100,
            "prop": null,
            "popularity": 50,
            "searches": 50,
            "site": "google.com",
            "sub": "google.com",
            "time": "2025-08-24 22:33:16",
            "prim": null,
            "https": false,
            "www": false
          }
        ]
      },
      {
        "kw": "portable hemodialysis unit cost",
        "data": [
          {
            "id": null,
            "page": "websearch?p=ws_settings_location&hl=uk&opi=89978449",
            "kw": "portable hemodialysis unit cost",
            "title": null,
            "date": "2026-06-28",
            "pos": 100,
            "prop": null,
            "popularity": 0,
            "searches": 0,
            "site": "google.com",
            "sub": "google.com",
            "time": "2025-08-25 08:50:13",
            "prim": null,
            "https": false,
            "www": false
          }
        ]
      }
    ]
  }
}

Frequently asked questions

Is the SERP API pay-as-you-go?
Yes. The SERP API offers plans or pay-as-you-go at $0.002 per request, with a $20 minimum top-up, plus 20 free requests per day.
What can the SERP API return?
Keyword positions and rankings by date for any domain, plus the keywords your competitors rank for.
Is there a free SERP API tier?
Yes, every account includes 20 free SERP API requests per day.

Search Engine API · Best Pages API · Keyword API · Competitors API