Kombat API Documentation (v1)

Access the Kombat data for any set of 1-3 websites. Fight on!

Authentication

Basic Auth Token

Security scheme type:	HTTP
HTTP Authorization Scheme	basic

api_key

Secret Key Authentication

Security scheme type:	API Key
Query parameter name:	api_key

KombatApi

Find successful keywords by comparing domains. Enter between 1 and 3 domains to find out the best keywords to use.

Get Organic Kombat Venn Data from 1-3 Domains Deprecated

get /get_organic_venn

https://www.spyfu.com:80/apis/kombat_api/get_organic_venn

query Parameters

domain1 required	string First Domain (required)
domain2	string Second Domain (optional)
domain3	string Third Domain (optional)
api_key	string User's secret key

Responses

200

500

InternalServerError

Request samples

cURL
JS
C#
PHP

Copy

curl "https://www.spyfu.com/apis/kombat_api/get_organic_venn?domain1=MyDomain.com&domain2=FirstCompetitor.com&domain3=SecondCompetitor.com&api_key=SECRET_KEY"

Response samples

Content type

Copy

Expand all Collapse all

{

"count1": 1096,
"count2": 50,
"count3": 40,
"count12": 987,
"count13": 653,
"count23": 1024,
"count123": 50000,
"universe": 150000

}

Getting the list of keywords for an Organic Kombat Combination. The process selects the list of keywords from the includedDomains, then removes any keywords from that list that belong to any of the domains in the excludedDomains list. Deprecated

get /get_organic_grid

https://www.spyfu.com:80/apis/kombat_api/get_organic_grid

query Parameters

includedDomainsCsv required	string Comma Separated list of domains to include keywords for.
excludedDomainsCsv	string Comma Separated list of domains to exclude keywords from.
r	integer <int32> Number of rows of data to return
isIntersection	boolean Only return Keywords ALL domains in the includeDomainsCsv contain. Otherwise include ANY keywords contained by ANY domains in the includeDomainsCsv
api_key	string User's secret key

Responses

200

500

InternalServerError

Request samples

cURL
JS
C#
PHP

Copy

curl "https://www.spyfu.com/apis/kombat_api/get_organic_grid?includedDomainsCsv=MyDomain.com,FirstCompetitor.com&excludedDomainsCsv=SecondCompetitor.com&r=100&isIntersection=true&api_key=SECRET_KEY"

Response samples

Content type

Copy

Expand all Collapse all

{

"gridRows":
[
- {
  - "termId": 123,
  - "term": "First Keyword",
  - "broadCostPerClick": 12,
  - "phraseCostPerClick": 13,
  - "exactCostPerClick": 15,
  - "broadCostPerDay": 2.45,
  - "phraseCostPerDay": 1.15,
  - "exactCostPerDay": 0.1,
  - "broadClicksPerDay": 1,
  - "phraseClicksPerDay": 5,
  - "exactClicksPerDay": 15,
  - "monthlyLocalExactSearchVolume": 1000,
  - "monthlyGlobalExactSearchVolume": 100,
  - "broadClickThroughRate": 0.4,
  - "phraseClickThroughRate": 0.01,
  - "exactClickThroughRate": 0.03,
  - "seoDifficulty": 67
  },
- {
  - "termId": 56431,
  - "term": "Second Keyword",
  - "broadCostPerClick": 2,
  - "phraseCostPerClick": 1,
  - "exactCostPerClick": 5,
  - "broadCostPerDay": 2.4,
  - "phraseCostPerDay": 1.11,
  - "exactCostPerDay": 0.15,
  - "broadClicksPerDay": 12,
  - "phraseClicksPerDay": 50,
  - "exactClicksPerDay": 1500,
  - "monthlyLocalExactSearchVolume": 9000,
  - "monthlyGlobalExactSearchVolume": 800,
  - "broadClickThroughRate": 0.45,
  - "phraseClickThroughRate": 0.11,
  - "exactClickThroughRate": 0.13,
  - "seoDifficulty": 88
  }
],
"rowsReturned": 40,
"totalRowsAvailable": 987

}

Get Paid Kombat Venn Data from 1-3 Domains Deprecated

get /get_paid_venn

https://www.spyfu.com:80/apis/kombat_api/get_paid_venn

query Parameters

domain1 required	string First Domain (required)
domain2	string Second Domain (optional)
domain3	string Third Domain (optional)
api_key	string User's secret key

Responses

200

500

InternalServerError

Request samples

cURL
JS
C#
PHP

Copy

curl "https://www.spyfu.com/apis/kombat_api/get_paid_venn?domain1=MyDomain.com&domain2=FirstCompetitor.com&domain3=SecondCompetitor.com&api_key=SECRET_KEY"

Response samples

Content type

Copy

Expand all Collapse all

{

"count1": 1096,
"count2": 50,
"count3": 40,
"count12": 987,
"count13": 653,
"count23": 1024,
"count123": 50000,
"universe": 150000

}

Getting the list of keywords for a Paid Kombat combination. The process selects the list of keywords from the includedDomains, then removes any keywords from that list that belong to any of the domains in the excludedDomains list. Deprecated

get /get_paid_grid

https://www.spyfu.com:80/apis/kombat_api/get_paid_grid

query Parameters

includedDomainsCsv required	string Comma Separated list of domains to include keywords for.
excludedDomainsCsv	string Comma Separated list of domains to exclude keywords from.
r	integer <int32> Number of rows of data to return
isIntersection	boolean Only return Keywords ALL domains in the includeDomainsCsv contain. Otherwise include ANY keywords contained by ANY domains in the includeDomainsCsv
api_key	string User's secret key

Responses

200

500

InternalServerError

Request samples

cURL
JS
C#
PHP

Copy

curl "https://www.spyfu.com/apis/kombat_api/get_paid_grid?includedDomainsCsv=MyDomain.com,FirstCompetitor.com&excludedDomainsCsv=SecondCompetitor.com&r=100&isIntersection=true&api_key=SECRET_KEY"

Response samples

Content type

Copy

Expand all Collapse all

{

"gridRows":
[
- {
  - "termId": 123,
  - "term": "First Keyword",
  - "broadCostPerClick": 12,
  - "phraseCostPerClick": 13,
  - "exactCostPerClick": 15,
  - "broadCostPerDay": 2.45,
  - "phraseCostPerDay": 1.15,
  - "exactCostPerDay": 0.1,
  - "broadClicksPerDay": 1,
  - "phraseClicksPerDay": 5,
  - "exactClicksPerDay": 15,
  - "monthlyLocalExactSearchVolume": 1000,
  - "monthlyGlobalExactSearchVolume": 100,
  - "broadClickThroughRate": 0.4,
  - "phraseClickThroughRate": 0.01,
  - "exactClickThroughRate": 0.03,
  - "advertisers": 12
  },
- {
  - "termId": 56431,
  - "term": "Second Keyword",
  - "broadCostPerClick": 2,
  - "phraseCostPerClick": 1,
  - "exactCostPerClick": 5,
  - "broadCostPerDay": 2.4,
  - "phraseCostPerDay": 1.11,
  - "exactCostPerDay": 0.15,
  - "broadClicksPerDay": 12,
  - "phraseClicksPerDay": 50,
  - "exactClicksPerDay": 1500,
  - "monthlyLocalExactSearchVolume": 9000,
  - "monthlyGlobalExactSearchVolume": 800,
  - "broadClickThroughRate": 0.45,
  - "phraseClickThroughRate": 0.11,
  - "exactClickThroughRate": 0.13,
  - "advertisers": 5
  }
],
"rowsReturned": 40,
"totalRowsAvailable": 987

}

Returns the Top Google Ads Buy recommendations for the domain Deprecated

get /get_advisor

https://www.spyfu.com:80/apis/kombat_api/get_advisor

query Parameters

domain required	string Domain to get recommendations for
r	integer <int32> max number of recommendations to retrieve
competitorsCsv	string List of comma separated competitors. Can be left out.
includedTermsCsv	string List of comma separated terms to use. Can be left out.
excludedTermsCsv	string List of comma separated terms to exclude. Can be left out.
api_key	string User's secret key

Responses

200

500

InternalServerError

Request samples

cURL
JS
C#
PHP

Copy

curl "https://www.spyfu.com/apis/kombat_api/get_advisor?domain=MyDomain.com&r=100&competitorsCsv=FirstCompetitor.com,SecondCompetitor.com&includedTermsCsv=Main Keyword,Keyword2,Keyword3,Keyword1000&excludedTermsCsv=Jokes,Dad Jokes,Funny Stuff&api_key=SECRET_KEY"

Response samples

Content type

Copy

Expand all Collapse all

{

"recommendations":
[
- {
  - "term": "Best Term",
  - "termId": 12345,
  - "avgWeight": 0.167,
  - "costPerClick": 1.1,
  - "costPerDay": 25.1,
  - "clicksPerDay": 2.15,
  - "impressionsPerMonth": 56,
  - "domains":
    [
    "DomainOnKeyword.com",
    "SecondDomainOnKeyword.com"
    ]
  },
- {
  - "term": "Second Best Term",
  - "termId": 56345,
  - "avgWeight": 0.667,
  - "costPerClick": 2.1,
  - "costPerDay": 2.11,
  - "clicksPerDay": 6.19,
  - "impressionsPerMonth": 26,
  - "domains":
    [
    "NextDomainOnKeyword.com",
    "DomainOnKeyword.com"
    ]
  }
],
"rowsReturned": 100,
"totalRows": 1098

}