Competitors API

Q: How is the Competitors API priced?

Plans or pay-as-you-go at 0.002 USD per request, 20 USD minimum top-up, plus 20 free requests per day.

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 Competitors API?

The Kwinside Competitors API shows how many sites compete for a keyword in each ranking bucket (TOP-1 through TOP-100), lists the rival domains, and returns their keywords and SERP positions. It has five endpoints under /api/v1/competitors/* — TOP counts, the list of competing domains, their rankings, their keywords, and TOP counts for a specific list of competitors. Responses are JSON, authenticated with your API key, and cover six languages. 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 for competitive analysis, share-of-voice tracking, or finding which domains to benchmark against in any niche.

Last updated: June 2026

The Competitors API has five endpoints — TOP counts, the list of competing domains, their SERP ranking, their keywords, and TOP counts for a specific list of competitors.

1. Competitor TOP counts by date

GET /api/v1/competitors/tops

This API is used to get the number of competitors in TOP-1, TOP-3, TOP-10, TOP-30, TOP-50, and TOP-100 for the specified site, 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
key	required	an API key that you can get in your account

Sample of a URI request:

</>GET

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

Response:

{ }200 · JSON

{
  "credits_info": {
    "credits_used": 1,
    "credits_remaining": 19
  },
  "data": {
    "0": {
      "date": "2026-05-18",
      "top1": 4079,
      "top3": 10443,
      "top10": 19510,
      "top30": 25395,
      "top50": 26243,
      "top100": 26342
    },
    "1": {
      "date": "2026-06-15",
      "top1": 4079,
      "top3": 10443,
      "top10": 19510,
      "top30": 25395,
      "top50": 26243,
      "top100": 26342
    }
  }
}

2. List of competing domains

GET /api/v1/competitors/list

This API is used to obtain a list of competitor sites for the specified site, search engine, and date range.

Parameters description:

Parameters	required	Description
site	required	domain name
se	required	search engine ID
sort_date	required	sort date, e.g.: 2020-05-05
dates	required	comma-separated dates: 2019-09-02,2019-09-09
top_filter	—	available values : 1, 3, 10, 30, 50, 100 (default value : 100)
size, offset	—	use these parameters to set the exact count of keywords in response and pagination
sort_type	—	available values: asc, desc (default value: desc)
site_filter	—	domain name
site_filter_type	—	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/competitors/list?site=google.com&se=1&dates=2026-06-02,2026-07-02&top_filter=100&size=5&sort_type=desc&key=example

Response:

{ }200 · JSON

{
  "credits_info": {
    "credits_used": 1,
    "credits_remaining": 19
  },
  "data": {
    "total": 26342,
    "result": [
      {
        "comp_site": "accounts.google.com",
        "data": [
          { "date": "2026-05-18", "count": 53591 },
          { "date": "2026-06-15", "count": 53591 }
        ]
      },
      {
        "comp_site": "en.wikipedia.org",
        "data": [
          { "date": "2026-05-18", "count": 49584 },
          { "date": "2026-06-15", "count": 49584 }
        ]
      },
      {
        "comp_site": "lumendatabase.org",
        "data": [
          { "date": "2026-05-18", "count": 44007 },
          { "date": "2026-06-15", "count": 44007 }
        ]
      },
      {
        "comp_site": "facebook.com",
        "data": [
          { "date": "2026-05-18", "count": 31436 },
          { "date": "2026-06-15", "count": 31436 }
        ]
      },
      {
        "comp_site": "play.google.com",
        "data": [
          { "date": "2026-05-18", "count": 27688 },
          { "date": "2026-06-15", "count": 27688 }
        ]
      }
    ],
    "debug": {},
    "sub": 0
  }
}

3. Competitor SERP ranking

GET /api/v1/competitors/rank

This API is used to obtain the rankings and the total number of keywords in TOP-100 for the specified site, search engine, and date range.

Parameters description:

Parameters	required	Description
site	required	domain name
se	required	search engine ID
sort_date	required	sort by date
key	required	an API key that you can get in your account

Sample of a URI request:

</>GET

1https://kwinside.com/api/v1/competitors/rank?site=google.com&se=1&sort_date=2026-06-02&key=example

Response:

{ }200 · JSON

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

4. Keywords by competitor

GET /api/v1/competitors/keywords

This API is used to obtain a list of competitor keywords for the specified sites, search engine, and date range.

Parameters description:

Parameters	required	Description
sites	required	comma-separated sites: kwinside.com, ahrefs.com
se	required	search engine ID
dates	required	comma-separated dates: 2019-09-02,2019-09-09
top_filter	—	available values : 1, 3, 10, 30, 50, 100 (default value : 100)
key	required	an API key that you can get in your account

Sample of a URI request:

</>GET

1https://kwinside.com/api/v1/competitors/keywords?sites=kwinside.com,ahrefs.com&se=1&dates=2026-06-02,2026-07-02&top_filter=100&key=example

Response:

{ }200 · JSON

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

5. TOP counts for a competitor list

POST /api/v1/competitors/tops_by_comps

This API is used to get a list of common keywords in TOP-1, TOP-3, TOP-10, TOP-30, TOP-50, and TOP-100 shared by the given site and a competitor’s site when ranked in a search engine for the specified date range.

Parameters description:

Parameters	required	Description
site	required	domain name
se	required	search engine ID
dates	—	comma-separated dates: 2019-09-02,2019-09-09
comps[]	required	competitors, 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/competitors/tops_by_comps?site=google.com&se=1&dates=2026-06-02,2026-07-02&comps[]=facebook.com&key=example

Response:

{ }200 · JSON

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

Frequently asked questions

What does the Competitors API do?

It returns how many sites compete in TOP-1 to TOP-100, the rival domains, their keywords and their SERP rankings for any site and search engine.

How is the Competitors API priced?

Plans or pay-as-you-go at $0.002 per request, $20 minimum top-up, plus 20 free requests per day.

Is there a free Competitors API tier?

Yes, every account includes 20 free requests per day across all Kwinside APIs.

SERP API · Search Engine API · Best Pages API · Keyword API