curl --request POST \
  --url https://developer.thehog.ai/api/v1/platform/scrapers/seo/keywords \
  --header 'Content-Type: application/json' \
  --header 'X-Access-Key: <api-key>' \
  --header 'X-Secret-Key: <api-key>' \
  --data '
{
  "domain": "acme.com",
  "searchType": "MostValuable",
  "pageSize": 25,
  "searchVolumeMin": 1,
  "searchVolumeMax": 1,
  "rankMin": 2,
  "rankMax": 2,
  "includeTerms": "<string>",
  "excludeTerms": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {
    'X-Access-Key': '<api-key>',
    'X-Secret-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    domain: 'acme.com',
    searchType: 'MostValuable',
    pageSize: 25,
    searchVolumeMin: 1,
    searchVolumeMax: 1,
    rankMin: 2,
    rankMax: 2,
    includeTerms: '<string>',
    excludeTerms: '<string>'
  })
};

fetch('https://developer.thehog.ai/api/v1/platform/scrapers/seo/keywords', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://developer.thehog.ai/api/v1/platform/scrapers/seo/keywords"

payload = {
    "domain": "acme.com",
    "searchType": "MostValuable",
    "pageSize": 25,
    "searchVolumeMin": 1,
    "searchVolumeMax": 1,
    "rankMin": 2,
    "rankMax": 2,
    "includeTerms": "<string>",
    "excludeTerms": "<string>"
}
headers = {
    "X-Access-Key": "<api-key>",
    "X-Secret-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "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>"
  }
}

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Validation failed",
  "path": "/api/v1/search",
  "timestamp": "2026-05-21T09:08:10.000Z",
  "requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b",
  "errors": [
    {
      "property": "body.query",
      "message": "query must be a string",
      "constraints": {
        "isString": "query must be a string"
      }
    }
  ]
}

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Authentication is required.",
  "path": "/api/v1/search",
  "timestamp": "2026-05-21T09:08:10.000Z",
  "requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}

{
  "statusCode": 402,
  "error": "Payment Required",
  "message": "Insufficient credits.",
  "path": "/api/v1/search",
  "timestamp": "2026-05-21T09:08:10.000Z",
  "requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}

{
  "statusCode": 500,
  "error": "Internal Server Error",
  "message": "An unexpected error occurred.",
  "path": "/api/v1/search",
  "timestamp": "2026-05-21T09:08:10.000Z",
  "requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}

{
  "statusCode": 502,
  "error": "Bad Gateway",
  "message": "An unexpected error occurred.",
  "path": "/api/v1/search",
  "timestamp": "2026-05-21T09:08:10.000Z",
  "requestId": "506af9b3-01a9-43be-9eb4-8458fe3e4f5b"
}