> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/docs/recipe-competitor-intel

# Competitor Intelligence

Explore Competitor Intelligence API documentation, request parameters, response fields, code examples, and error handling for DomScan integrations.

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

```bash
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"
```

```javascript
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);
```

```python
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())
```

```go
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))
}
```

```ruby
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

```json
{
  "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

- `200` OK
- `400` Bad Request
- `401` Unauthorized
- `402` Payment Required
- `429` Too Many Requests
