Documentation on Deteqtivehttps://deteqtive.com/docs/Recent content in Documentation on DeteqtiveHugoen-usTutorialhttps://deteqtive.com/docs/tutorial/Mon, 01 Jan 0001 00:00:00 +0000https://deteqtive.com/docs/tutorial/<!-- IMPORTANT: The YAML front matter above is required for the CMS. Do not remove or modify it. --> <h1 id="tutorial-getting-started-with-deteqtive-dns-api">Tutorial: Getting Started with DETEQTIVE DNS API</h1> <blockquote> <p><strong>Learning-oriented:</strong> This tutorial will guide you through your first steps with the DETEQTIVE DNS API, from understanding what passive DNS is to making your first successful queries.</p> </blockquote> <h2 id="authentication">Authentication</h2> <p>All API requests require a Bearer token. Set it once in your shell and all examples will work:</p>How-To Guideshttps://deteqtive.com/docs/how-to-guides/Mon, 01 Jan 0001 00:00:00 +0000https://deteqtive.com/docs/how-to-guides/<!-- IMPORTANT: The YAML front matter above is required for the CMS. Do not remove or modify it. --> <h1 id="how-to-guides-deteqtive-dns-api">How-To Guides: DETEQTIVE DNS API</h1> <blockquote> <p><strong>Problem-oriented:</strong> Practical guides for accomplishing specific tasks with the DETEQTIVE DNS API.</p> </blockquote> <h2 id="authentication">Authentication</h2> <p>All API requests require a Bearer token. Set it once in your shell and all examples will work:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nb">export</span> <span class="nv">DETEQTIVE_TOKEN</span><span class="o">=</span><span class="s2">&#34;your-api-token-here&#34;</span> </span></span></code></pre></div><h2 id="table-of-contents">Table of Contents</h2> <ul> <li> <a href="#searching-domains">Searching Domains</a> </li> <li> <a href="#finding-ip-addresses">Finding IP Addresses</a> </li> <li> <a href="#reverse-dns-lookups">Reverse DNS Lookups</a> </li> <li> <a href="#cidr-block-searches">CIDR Block Searches</a> </li> <li> <a href="#time-based-filtering">Time-Based Filtering</a> </li> <li> <a href="#working-with-large-result-sets">Working with Large Result Sets</a> </li> <li> <a href="#parsing-responses">Parsing Responses</a> </li> <li> <a href="#generating-api-clients">Generating API Clients</a> </li> <li> <a href="#integration-examples">Integration Examples</a> </li> <li> <a href="#performance-optimization">Performance Optimization</a> </li> </ul> <hr> <h2 id="searching-domains">Searching Domains</h2> <h3 id="how-to-search-for-an-exact-domain">How to search for an exact domain</h3> <p><strong>Task:</strong> Find all DNS records for a specific domain.</p>Referencehttps://deteqtive.com/docs/reference/Mon, 01 Jan 0001 00:00:00 +0000https://deteqtive.com/docs/reference/<!-- IMPORTANT: The YAML front matter above is required for the CMS. Do not remove or modify it. --> <h1 id="reference-deteqtive-dns-api">Reference: DETEQTIVE DNS API</h1> <blockquote> <p><strong>Information-oriented:</strong> Complete technical reference for the DETEQTIVE DNS API.</p> </blockquote> <h2 id="authentication">Authentication</h2> <p>All API requests require a Bearer token. Set it once in your shell and all examples will work:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nb">export</span> <span class="nv">DETEQTIVE_TOKEN</span><span class="o">=</span><span class="s2">&#34;your-api-token-here&#34;</span> </span></span></code></pre></div><h2 id="api-version">API Version</h2> <p><strong>Current Version:</strong> v3 <strong>Base Path:</strong> <code>/api/v3</code> <strong>Specification:</strong> OpenAPI 3.0.3</p> <h2 id="base-urls">Base URLs</h2> <table> <thead> <tr> <th>Environment</th> <th>URL</th> </tr> </thead> <tbody> <tr> <td>Production</td> <td><code>https://api.deteqtive.com/api/v3</code></td> </tr> </tbody> </table> <h2 id="endpoints">Endpoints</h2> <h3 id="forward-search-rrset---search-by-domain">Forward Search (RRSet) - Search by Domain</h3> <p>Search for DNS records by domain name using various matching strategies.</p>Explanationhttps://deteqtive.com/docs/explanation/Mon, 01 Jan 0001 00:00:00 +0000https://deteqtive.com/docs/explanation/<!-- IMPORTANT: The YAML front matter above is required for the CMS. Do not remove or modify it. --> <h1 id="explanation-understanding-deteqtive-dns-api">Explanation: Understanding DETEQTIVE DNS API</h1> <blockquote> <p><strong>Understanding-oriented:</strong> Deep dive into concepts, design decisions, and the thinking behind the DETEQTIVE DNS API.</p> </blockquote> <h2 id="authentication">Authentication</h2> <p>All API requests require a Bearer token. Set it once in your shell and all examples will work:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nb">export</span> <span class="nv">DETEQTIVE_TOKEN</span><span class="o">=</span><span class="s2">&#34;your-api-token-here&#34;</span> </span></span></code></pre></div><h2 id="table-of-contents">Table of Contents</h2> <ul> <li> <a href="#what-is-passive-dns">What is Passive DNS?</a> </li> <li> <a href="#how-the-api-works">How the API Works</a> </li> <li> <a href="#search-strategies">Search Strategies</a> </li> <li> <a href="#ndjson-streaming">NDJSON Streaming</a> </li> <li> <a href="#error-handling-philosophy">Error Handling Philosophy</a> </li> <li> <a href="#time-based-data">Time-Based Data</a> </li> <li> <a href="#bailiwick-concept">Bailiwick Concept</a> </li> <li> <a href="#performance-considerations">Performance Considerations</a> </li> <li> <a href="#security-and-privacy">Security and Privacy</a> </li> <li> <a href="#data-collection-and-quality">Data Collection and Quality</a> </li> </ul> <hr> <h2 id="what-is-passive-dns">What is Passive DNS?</h2> <h3 id="the-concept">The Concept</h3> <p><strong>Passive DNS</strong> is fundamentally different from traditional (active) DNS lookups:</p>