> ## 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.

# Google Dork Lookup

> Generate a categorized pack of ready-to-run Google dorks for a person, email, username, or domain. Keyless and free costs no credits.

## Authentication

Requires an API key in the `Authorization` header.

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

## Request

<ParamField body="query" type="string" required>
  The subject to build dorks for a name, email address, username, domain, or a
  free-text keyword phrase. If your query already contains Google operators
  (e.g. `filetype:pdf`, `site:github.com`) or quotes, they are automatically
  detected and stripped so the true subject is quoted exactly once you never
  get broken syntax like nested quotes.
</ParamField>

## Response

Returns the detected query type, the normalized subject, any operators detected in your input, and a categorized set of ready-to-run Google dork links. This is a dedicated endpoint (not a Google search) it does **not** hit a search engine and costs **0 credits**.

<ResponseField name="query" type="string">The raw subject you sent.</ResponseField>
<ResponseField name="query_type" type="string">Detected query type: `person`, `email`, `username`, `domain`, `url`, `company`, or `keyword`.</ResponseField>
<ResponseField name="normalized_query" type="string">The cleaned subject after stripping operators and quotes this is what gets quoted in the dorks.</ResponseField>
<ResponseField name="detected_operators" type="object">Map of any Google operators found in your input, e.g. `{ "filetype": "pdf" }`. Omitted when none are detected.</ResponseField>

<ResponseField name="dork_pack" type="object[]">
  Categorized dork links tuned to the query type. Categories are query-type aware a person gets social/documents/forums/code, an email gets breach/paste/documents/code, a domain gets recon/documents/cloud/code/backups, a company gets news/documents/jobs/code, and a keyword gets documents/forums/code/news.

  <Expandable title="dork_pack[]">
    <ResponseField name="category" type="string">Category name, e.g. `Documents & Files`.</ResponseField>
    <ResponseField name="risk_level" type="string">Sensitivity of the category: `low`, `medium`, or `sensitive`.</ResponseField>

    <ResponseField name="dorks" type="object[]">
      <Expandable title="dorks[]">
        <ResponseField name="label" type="string">Human-friendly label for the dork.</ResponseField>
        <ResponseField name="dork" type="string">The raw Google dork query string.</ResponseField>
        <ResponseField name="url" type="string">A ready-to-open Google search URL for the dork.</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="excluded_categories" type="object[]">
  Categories that were intentionally withheld and why. The sensitive **Credentials & Secrets** pack is only included for authorized `domain`/`url` searches (defensive security on your own asset); for people, emails, and keywords it is withheld and reported here.

  <Expandable title="excluded_categories[]">
    <ResponseField name="category" type="string">The withheld category name.</ResponseField>
    <ResponseField name="reason" type="string">Why it was withheld.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="credits" type="number">Always `0` this endpoint is free.</ResponseField>

<ResponseExample>
  ```json theme={"dark"}
  {
    "query": "filetype:pdf \"leaked emails dark web\"",
    "query_type": "keyword",
    "normalized_query": "leaked emails dark web",
    "detected_operators": { "filetype": "pdf" },
    "dork_pack": [
      {
        "category": "Documents & Files",
        "risk_level": "low",
        "dorks": [
          {
            "label": "PDF",
            "dork": "\"leaked emails dark web\" filetype:pdf",
            "url": "https://www.google.com/search?q=%22leaked+emails+dark+web%22+filetype%3Apdf"
          }
        ]
      }
    ],
    "excluded_categories": [
      {
        "category": "Credentials & Secrets",
        "reason": "Withheld: credential/secret dorks are only shown for authorized searches on your own domain (defensive security use only)."
      }
    ],
    "credits": 0
  }
  ```
</ResponseExample>

## Credits

Free this endpoint never deducts credits.