Documentation

Keyword Competitors API

The Search Competitors Pro API provides streamlined access to all the domains that are competing against the chosen domain for the same Organic or Paid keywords. The higher the site returned is ranked, the more keywords it has in common with the analyzed domain.


Endpoints

  • URL of competitors on organic keywords + competition score - "organicsearchcompetitors"


  • URL of competitors on paid keywords + competition score - "paidsearchcompetitors"


Parameters

Params Description
Domain Enter your target domain including only the top-level and second-level names, ie: "google.com"
Start Month (start_date) Start Month (YYYY-MM)
End Month (end_date) End Month (YYYY-MM)
Main Domain (main_domain_only) True /False
True returns data for main domain only
False returns data for subdomains as well.
UserKey (api_key) Enter your unique API Key

Example: Organic Search Competitors Pro API input for "cnn.com"


{
https://api.similarweb.com/v1/website/cnn.com/search-competitors/organicsearchcompetitors?api_key={UserKey}&start_date=2016-09&end_date=2016-11
}

Example: Organic Search Competitors Pro API output in JSON for "google.com"


{
data": [

    {
        "url": "nytimes.com",
        "score": 0.16131379659052683
    },
    {
        "url": "usatoday.com",
        "score": 0.1230062408909592
    },
    {
        "url": "washingtonpost.com",
        "score": 0.12281973390549328
    },
    {
        "url": "nbcnews.com",
        "score": 0.095810804241590108
    },
    {
        "url": "politico.com",
        "score": 0.091629704972378281
    },
    {
        "url": "npr.org",
        "score": 0.0724683669091669
    },
    ...

Example: cnn.com Paid Search Competitors Pro API input


{
https://api.similarweb.com/v1/website/cnn.com/search-competitors/paidsearchcompetitors?api_key={UserKey}&start_date=2016-09&end_date=2016-11
}

Example: Paid Search Competitors Pro API output in JSON for "cnn.com"


{
data": [

    {
        "url": "care.org",
        "score": 0.40581550927907056
    },
    {
        "url": "ballotpedia.org",
        "score": 0.29619074265742984
    },
    {
        "url": "act.weareultraviolet.org",
        "score": 0.20818333116433452
    },
    {
        "url": "abcnews.go.com",
        "score": 0.18292957369725193
    },
    {
        "url": "convergedinfrastructure.com",
        "score": 0.17627536592815224
    },
    {
        "url": "oceanstatecurrent.com",
        "score": 0.10990381972121693
    },
    {
        "url": "carolinajournal.com",
        "score": 0.10436263943392726
    },
    {
        "url": "democracynow.org",
        "score": 0.10078409622315096
    },
    .....