Skip to main content
POST
/
api
/
v1
/
platform
/
scrapers
/
seo
/
competing-keywords
Get shared SEO keywords
curl --request POST \
  --url https://developer.thehog.ai/api/v1/platform/scrapers/seo/competing-keywords \
  --header 'Content-Type: application/json' \
  --header 'X-Access-Key: <api-key>' \
  --header 'X-Secret-Key: <api-key>' \
  --data '
{
  "includedDomains": [
    "acme.com",
    "competitor.com"
  ],
  "excludedDomains": [
    "excluded.com"
  ],
  "pageSize": 25
}
'
{
  "data": {
    "resultCount": 123,
    "totalMatchingResults": 123,
    "keywords": [
      {
        "keyword": "<string>",
        "searchVolume": 123,
        "rank": 123,
        "rankingDifficulty": 123,
        "totalMonthlyClicks": 123,
        "percentOrganicClicks": 123,
        "broadCostPerClick": 123,
        "isQuestion": true
      }
    ],
    "domain": "<string>",
    "seedKeyword": "<string>",
    "includedDomains": [
      "<string>"
    ],
    "excludedDomains": [
      "<string>"
    ],
    "searchType": "<string>"
  },
  "meta": {
    "requestId": "<string>"
  }
}

POST /api/v1/platform/scrapers/seo/competing-keywords

Find organic keywords shared across domains.
Compare one or more competitor domains to discover overlapping organic keywords. Optionally exclude domains from the comparison.

Example

curl -X POST https://developer.thehog.ai/api/v1/platform/scrapers/seo/competing-keywords \
  -H "X-Access-Key: ak_xxxxxxxxxxxxxxxx" \
  -H "X-Secret-Key: sk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"includedDomains": ["acme.com", "competitor.com"], "pageSize": 25}'

Authorizations

X-Access-Key
string
header
required

The public API key from the Credentials page.

X-Secret-Key
string
header
required

The API secret shown when the credential is created.

Body

application/json
includedDomains
string[]
required

Domains to compare for shared keywords.

Example:
["acme.com", "competitor.com"]
excludedDomains
string[]

Domains to exclude from the comparison.

Example:
["excluded.com"]
pageSize
number
default:25
Required range: 1 <= x <= 100

Response

Organic keywords shared across domains.

data
object
required
meta
object
required