Developer reference
Competitor Intelligence
Explore Competitor Intelligence API documentation, request parameters, response fields, code examples, and error handling for DomScan integrations.
Competitor Intelligence
Analyze your competitor's digital infrastructure. Discover their tech stack, hosting providers, DNS configuration, SSL setup, and online presence to inform your own strategy.
GET
/v1/recipes/competitor-intel
Credits: 15
Query parameters
| Parameter | Type | required |
|---|---|---|
| domain | string | required |
| discover_subdomains |
boolean
Default
true
|
optional |
| analyze_infrastructure |
boolean
Default
true
|
optional |
| analyze_email |
boolean
Default
true
|
optional |
| dry_run |
string
Allowed values
true
|
optional |
Response fields
| Field | Type |
|---|---|
success |
boolean |
data |
object |
data.domain |
string |
data.company |
object |
data.company.name |
string |
data.company.industry |
string |
data.company.description |
string |
data.infrastructure |
object |
data.infrastructure.hosting |
string |
data.infrastructure.cdn |
string |
data.infrastructure.dns_provider |
string |
data.infrastructure.email_provider |
string |
data.infrastructure.ip_addresses[] |
string[] |
data.technology |
object |
data.technology.cms |
null |
data.technology.frameworks[] |
string[] |
data.technology.analytics[] |
string[] |
data.technology.marketing[] |
string[] |
data.technology.all_detected[] |
string[] |
data.digital_footprint |
object |
data.digital_footprint.subdomains_found[] |
string[] |
data.digital_footprint.ssl_certificates |
number |
data.digital_footprint.email_security_grade |
string |
data.insights[] |
string[] |
meta |
object |
meta.recipe_name |
string |
meta.credits_used |
number |
meta.credits_saved |
number |
meta.duration_ms |
number |
meta.components_called[] |
string[] |
meta.cached_components[] |
string[] |
meta.timestamp |
string |
errors[] |
array |
Example request
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/recipes/competitor-intel?domain=example.com&discover_subdomains=true&analyze_infrastructure=true&analyze_email=true"const response = await fetch("https://domscan.net/v1/recipes/competitor-intel?domain=example.com&discover_subdomains=true&analyze_infrastructure=true&analyze_email=true", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/recipes/competitor-intel?domain=example.com&discover_subdomains=true&analyze_infrastructure=true&analyze_email=true",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/recipes/competitor-intel?domain=example.com&discover_subdomains=true&analyze_infrastructure=true&analyze_email=true", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/recipes/competitor-intel?domain=example.com&discover_subdomains=true&analyze_infrastructure=true&analyze_email=true")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))Example response
{
"success": true,
"data": {
"domain": "competitor.com",
"company": {
"name": "Competitor Inc.",
"industry": "SaaS",
"description": "B2B workflow platform"
},
"infrastructure": {
"hosting": "Vercel",
"cdn": "Cloudflare",
"dns_provider": "Cloudflare",
"email_provider": "Google Workspace",
"ip_addresses": [
"198.51.100.11",
"198.51.100.12"
]
},
"technology": {
"cms": null,
"frameworks": [
"Next.js"
],
"analytics": [
"Google Analytics"
],
"marketing": [
"HubSpot"
],
"all_detected": [
"Cloudflare",
"Next.js",
"HubSpot",
"Google Analytics"
]
},
"digital_footprint": {
"subdomains_found": [
"www",
"app",
"api",
"status"
],
"ssl_certificates": 5,
"email_security_grade": "A"
},
"insights": [
"Cloudflare is fronting the main web stack.",
"Separate status infrastructure is publicly exposed."
]
},
"meta": {
"recipe_name": "competitor-intelligence",
"credits_used": 15,
"credits_saved": 5,
"duration_ms": 915,
"components_called": [
"whois",
"dns",
"dns-security",
"tech",
"subdomains",
"certificates",
"ip"
],
"cached_components": [
"dns"
],
"timestamp": "2026-04-15T10:22:00Z"
},
"errors": []
}
HTTP status codes
200OK400Bad Request401Unauthorized402Payment Required429Too Many Requests