SERP API
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 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/topsThis 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 |
|---|---|---|
| site | required | domain name |
| se | required | search engine ID |
| dates | required | comma-separated dates: 2019-09-02,2019-09-09 |
| sub | — | with subdomains (available values: 0, 1) |
| key | required | an API key that you can get in your account |
Sample of a URI request:
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:
{
"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/listThis 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 |
|---|---|---|
| site | required | domain name |
| se | required | search engine ID |
| sort_date | required | available values: asc, desc (default value: desc) |
| dates | — | comma-separated dates: 2019-09-02,2019-09-09 |
| sort_type | — | available values: asc, desc (default value: desc) |
| 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) |
| kw_filter_type | — | available values: match |
| kw_filter | — | filter keyword |
| page_filter_type | — | available values: match |
| page_filter | — | filter page |
| sort_by | — | available values: pos, kw, py (default value: pos) |
| pos_filter | — | available values: all, not_positions, changed, not_changed, moved_up, moved_down, entered, dropped, all_filter (default: all) |
| add_null | — | available values: true, false |
| sub | — | with subdomains (available values: 0, 1) |
| key | required | an API key that you can get in your account |
Sample of a URI request:
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:
{
"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?
What can the SERP API return?
Is there a free SERP API tier?
Search Engine API · Best Pages API · Keyword API · Competitors API