The Domain SEO API

# 1. Keyword footprint — cheap, no positions (2 credits flat)
curl "https://api.searlo.tech/api/v1/domain/keywords?domain=yourdomain.com&limit=50" \
  -H "x-api-key: YOUR_API_KEY"

# 2. Verified top pages — always runs a live SERP per keyword checked
curl "https://api.searlo.tech/api/v1/domain/top-pages?domain=yourdomain.com&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

# 3. Competitors — co-occurrence across SERPs this call verifies independently
curl "https://api.searlo.tech/api/v1/domain/competitors?domain=yourdomain.com&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

# 4. Keyword gap — what up to 10 rivals are associated with that you are not
curl "https://api.searlo.tech/api/v1/domain/gaps?target=yourdomain.com&competitors=competitor1.com,competitor2.com&result_limit=50" \
  -H "x-api-key: YOUR_API_KEY"

# 5. Overview — footprint, topics and (if verified) measured visibility
curl "https://api.searlo.tech/api/v1/domain/overview?domain=yourdomain.com" \
  -H "x-api-key: YOUR_API_KEY"

import requests

BASE = "https://api.searlo.tech/api/v1"
HEADERS = {"x-api-key": "YOUR_API_KEY"}
domain = "yourdomain.com"
rivals = "competitor1.com,competitor2.com"

# 1. Keyword footprint — Google Ads site-seed association, no positions.
# 2 credits flat. Add verify=True to run a live SERP on up to 10 of these
# keywords per call (adds 3 credits x depth-in-pages per keyword verified).
keywords = requests.get(f"{BASE}/domain/keywords",
                         params={"domain": domain, "limit": 50},
                         headers=HEADERS).json()["results"]

# 2. Verified top pages — no `verify` param; every call runs SERPs.
top_pages = requests.get(f"{BASE}/domain/top-pages",
                          params={"domain": domain, "limit": 20},
                          headers=HEADERS).json()["results"]

# 3. Competitors — domains co-occurring on the SERPs this call verified.
competitors = requests.get(f"{BASE}/domain/competitors",
                            params={"domain": domain, "limit": 20},
                            headers=HEADERS).json()["results"]

# 4. Keyword gap — keywords the rivals are associated with that the target
# is not. Cheap by default (Ads association on both sides); verify=True
# measures the target's live position on the gap keywords instead.
gaps = requests.get(f"{BASE}/domain/gaps",
                     params={"target": domain, "competitors": rivals, "result_limit": 50},
                     headers=HEADERS).json()["results"]

# 5. Overview — footprint, topics, and organic_visibility (None unless verified).
overview = requests.get(f"{BASE}/domain/overview",
                         params={"domain": domain},
                         headers=HEADERS).json()["result"]

print(len(keywords), "keywords,", len(top_pages), "top pages,",
      len(competitors), "competitors,", len(gaps), "gap keywords")
print(overview["keyword_footprint"], "total footprint,",
      overview["total_search_volume"], "monthly search volume")

const BASE = "https://api.searlo.tech/api/v1";
const headers = { "x-api-key": "YOUR_API_KEY" };
const domain = "yourdomain.com";
const rivals = "competitor1.com,competitor2.com";

// 1. Keyword footprint — Ads site-seed association, no positions. 2 credits flat.
const { results: keywords } = await (await fetch(
  `${BASE}/domain/keywords?domain=${domain}&limit=50`, { headers },
)).json();

// 2. Verified top pages — every call runs SERPs, no `verify` param to set.
const { results: topPages } = await (await fetch(
  `${BASE}/domain/top-pages?domain=${domain}&limit=20`, { headers },
)).json();

// 3. Competitors — co-occurrence on the SERPs this call verified.
const { results: competitors } = await (await fetch(
  `${BASE}/domain/competitors?domain=${domain}&limit=20`, { headers },
)).json();

// 4. Keyword gap — up to 10 competitor domains, comma-separated.
const gapParams = new URLSearchParams({ target: domain, competitors: rivals, result_limit: "50" });
const { results: gaps } = await (await fetch(
  `${BASE}/domain/gaps?${gapParams}`, { headers },
)).json();

// 5. Overview — organic_visibility is null unless a verified call fed it.
const { result: overview } = await (await fetch(
  `${BASE}/domain/overview?domain=${domain}`, { headers },
)).json();

console.log(keywords.length, "keywords,", topPages.length, "top pages,",
  competitors.length, "competitors,", gaps.length, "gap keywords");
console.log(overview.keyword_footprint, "total footprint,",
  overview.total_search_volume, "monthly search volume");