DNS Record Lookups¶

This page covers the core lookup flows in the DNS Toolkit: single-record queries, all-record lookups, bulk checks, and propagation analysis.

Common lookup endpoints¶

Endpoint	Purpose
`GET /v1/lookup`	Query a specific DNS record type
`GET /v1/lookup/all`	Return the common record families in one call
`POST /v1/lookup/bulk`	Resolve many domains at once
`GET /v1/propagation`	Check whether a record has propagated globally
`GET /v1/compare-resolvers`	Compare answers from public DNS resolvers

Python SDK examples¶

A record lookup¶

from toolkitapi import DNS

with DNS(api_key="tk_...") as dns:
    result = dns.lookup("toolkitapi.io", type="A")
    print(result)

MX records¶

from toolkitapi import DNS

with DNS(api_key="tk_...") as dns:
    result = dns.lookup("google.com", type="MX")
    print(result["records"])

Retrieve all common records¶

from toolkitapi import DNS

with DNS(api_key="tk_...") as dns:
    result = dns.lookup_all("toolkitapi.io")
    print(result)

Bulk lookup¶

from toolkitapi import DNS

with DNS(api_key="tk_...") as dns:
    result = dns.lookup_bulk(
        ["toolkitapi.io", "github.com", "python.org"],
        type="A",
    )
    print(result)

Propagation check¶

from toolkitapi import DNS

with DNS(api_key="tk_...") as dns:
    result = dns.propagation("toolkitapi.io", type="TXT")
    print(result)

Compare public resolvers¶

from toolkitapi import DNS

with DNS(api_key="tk_...") as dns:
    result = dns.compare_resolvers("toolkitapi.io", type="A")
    print(result)

Tips¶

Use lookup_all when you need a complete domain overview quickly
Use propagation after DNS changes to verify rollout
Use compare_resolvers to debug caching or split-horizon problems

Reference and sync notes¶

These lookup flows map directly to the live DNS OpenAPI contract:

single lookup-style operations are GET endpoints
bulk resolution is a POST endpoint
the API reference at https://dns.toolkitapi.io/documentation owns the exact parameter schema and response fields

Jump straight to live tools¶

https://dns.toolkitapi.io/tools/lookup/
https://dns.toolkitapi.io/tools/lookup-all/
https://dns.toolkitapi.io/tools/lookup-bulk/
https://dns.toolkitapi.io/tools/propagation/
https://dns.toolkitapi.io/tools/compare-resolvers/

DNS Toolkit

Domain Intelligence