MCP documentation menu

datapulse_dns_searchlabels

OtherScope: datapulse:dnsRead-only

Search the corpus for registrable (PSL+1) labels like a search term, with every TLD where each label is listed: the starting point for …

Description

Search the corpus for registrable (PSL+1) labels like a search term, with every TLD where each label is listed: the starting point for typosquatting, impersonation and lookalike questions. Hostnames are not indexed. It matches domain-name labels only and cannot find domains by registrant (no reverse-WHOIS; see datapulse_help(topic="rdap")).

Match types exact, substring and fuzzy (filter narrows them); score is Levenshtein edit distance, nearest first. Fuzzy matching targets homoglyphs and IDN confusables and does NOT systematically find plain typos: each typo variant is checked with filter=[“exact”].

Response: CSV label,type,score,tlds, at most 100 labels. Up to two lines can precede the header: error: ... (the API’s error text) and complete: false (...) when the label limit was reached or the API cut its answer short, so more labels exist; there is no paging, and a narrower filter or longer term reduces the set. tlds is the complete pipe-delimited list of TLDs where the label is listed. Listed is not registered: the corpus holds active names only, so a missing TLD may still be registered. A very common term can time out; filter narrows it.

Reference: datapulse_help(topic="searchlabels")

Parameters

ParameterTypeDescription
search_term
required
string
One label to search for: paypal, not paypal.com. Dots at either end are dropped; a dot inside is refused. Any UTF-8 text.
Min length: 3Max length: 255
filterstring[]
Restrict to listed match types.
Input schema (JSON)
{
  "additionalProperties": false,
  "properties": {
    "filter": {
      "description": "Restrict to listed match types.",
      "items": {
        "enum": [
          "exact",
          "substring",
          "fuzzy"
        ],
        "maxLength": 9,
        "type": "string"
      },
      "type": "array"
    },
    "search_term": {
      "description": "One label to search for: paypal, not paypal.com. Dots at either end are dropped; a dot inside is refused. Any UTF-8 text.",
      "maxLength": 255,
      "minLength": 3,
      "type": "string"
    }
  },
  "required": [
    "search_term"
  ],
  "type": "object"
}

Generated from the live server (DataPulse MCP v0.9-341-g27163c2) on October 20, 2026.