> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encrata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bulk Domain Search

> Run domain intelligence on multiple domains in a single request.

## Authentication

Requires a JWT token or API key in the `Authorization` header.

```bash theme={"dark"}
Authorization: Bearer YOUR_TOKEN
```

## Request

<ParamField body="queries" type="string[]" required>
  Array of domain names (max 100).
</ParamField>

### Example request

```bash theme={"dark"}
curl -X POST "https://encrata.com/api/bulk-domain-search" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "queries": ["example.com", "startup.io", "corp.co"] }'
```

## Response

Returns an array of domain intelligence results. Each result includes WHOIS data, the
Google knowledge graph, organic search results, and a structured 16-section OSINT
`report`.

```json theme={"dark"}
{
  "results": [
    {
      "query": "example.com",
      "whois": { "domain_name": "example.com", "registrar": "...", "name_servers": [...] },
      "knowledge_graph": { "title": "Example", "type": "...", "description": "..." },
      "organic": [ { "title": "...", "link": "...", "snippet": "..." } ],
      "report": { "summary": {...}, "dns_intel": {...}, "infra": {...}, "...": "..." }
    }
  ],
  "credits_used": 3
}
```

<ResponseField name="report" type="object">
  Structured OSINT report compiled from the gathered intelligence. Contains 16 sections:
  `summary` (executive overview with stats), `dns_intel`, `infra`, `subdomains`, `website`,
  `tech_stack`, `security`, `company`, `marketing`, `documents`, `email`, `risk`,
  `historical` (Wayback / certificate transparency), `gaps`, `next_steps`, and `sources`.

  In bulk mode only domain, WHOIS, knowledge graph, and organic inputs are available, so
  sections that depend on live DNS, SSL, or internet-exposure data degrade gracefully.
</ResponseField>

## Credits

Each query consumes **1 credit**.
