# 🌐 DNS Propagation Checker — Global Resolver Bulk Tool (`nexgendata/dns-propagation-checker`) Actor Check DNS propagation across 15 global resolvers (Google, Cloudflare, Quad9, OpenDNS, Verisign, Yandex). Detects inconsistency, reports by-region variance, returns TTL and full record data. - **URL**: https://apify.com/nexgendata/dns-propagation-checker.md - **Developed by:** [Stephan Corbeil](https://apify.com/nexgendata) (community) - **Categories:** Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🌐 DNS Propagation Checker — Global Resolver Bulk Tool Checks how a domain resolves across **15 major global DNS resolvers** — Google, Cloudflare, Quad9, OpenDNS, Verisign, Yandex, AdGuard, CleanBrowsing, Neustar, and more. Detects mid-propagation inconsistency, regional cache poisoning, and misconfigured authoritative servers. DNSChecker.org's free tier caps you at 1 domain per check. Their Pro plan is $29/mo for bulk. This actor runs 15 resolvers × N domains in parallel for **$0.002 per domain-check**. ### What it does For every domain and record type you provide: - Queries 15 geographically diverse resolvers in parallel - Groups identical responses together ("consistency groups") - Returns **propagation status**: `fully_propagated` / `partially_propagated` / `inconsistent` / `no_data` - Reports per-resolver: records returned, TTL, NXDOMAIN/NoAnswer flags, errors - Covers record types A, AAAA, MX, TXT, NS, CNAME, SOA, CAA ### Example ```python import requests r = requests.post( "https://api.apify.com/v2/acts/nexgendata~dns-propagation-checker/run-sync-get-dataset-items?token=" + APIFY_TOKEN, json={ "domains": ["newdomain.example.com"], "recordTypes": ["A", "MX"] } ) for r_item in r.json(): print(f"{r_item['domain']} {r_item['record_type']} — {r_item['propagation_status']}") print(f" {r_item['unique_responses']} unique responses across {r_item['total_resolvers']} resolvers") for group in r_item["groups"]: print(f" [{group['resolver_count']} resolvers] → {group['records']}") ```` Sample output: ``` newdomain.example.com A — partially_propagated 2 unique responses across 15 resolvers [12 resolvers] → ['203.0.113.50'] [3 resolvers] → ['203.0.113.99'] ← stale cache newdomain.example.com MX — fully_propagated 1 unique responses across 15 resolvers ``` ### cURL ```bash curl -X POST "https://api.apify.com/v2/acts/nexgendata~dns-propagation-checker/run-sync-get-dataset-items?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"domains":["example.com"],"recordTypes":["A","AAAA","MX","TXT"]}' ``` ### Common use cases - **Post-change verification** — after a DNS update, confirm it's live everywhere before cutting over traffic - **CDN debugging** — CDN pointing to old IP in one region? Find which resolvers are stale - **Email delivery investigation** — MX records inconsistent means deliverability problems - **SPF/DKIM/DMARC rollout** — verify TXT records propagated globally before flipping enforcement policy - **CAA enforcement verification** — before requesting new TLS certs, confirm CAA records are propagated ### Why 15 resolvers, not 50? Most "global DNS" tools claim 40-60 resolvers but 90% of them share cache infrastructure — querying them is redundant. The 15 we query are **operator-distinct**: Google, Cloudflare, Quad9, OpenDNS (Cisco), Verisign, Yandex, AdGuard, NextDNS, Cisco Umbrella, Neustar, etc. Each has independent cache behavior. You see real diversity, not noise. ### Pricing - **$0.005 per run** (startup) - **$0.002 per domain-check** (one record type on one domain) 10 domains × 4 record types = 40 domain-checks = **$0.085**. ### FAQ **Q: Does this query authoritative servers or just recursive resolvers?** A: Recursive resolvers. That's the point — we're measuring what *users* see, not what the zone file says. **Q: TTL countdown?** A: Each resolver's current TTL is returned. Useful for predicting when a stale response will expire. **Q: Can I check internal / private domains?** A: No — external resolvers can't resolve your internal zones. **Q: What's "inconsistent" mean vs. "partially\_propagated"?** A: `partially_propagated` = exactly 2 unique responses (classic mid-migration state). `inconsistent` = 3+ unique responses (either active attack, misconfigured split-horizon, or broken authoritative servers). ### Related tools - [WHOIS Domain Lookup](https://apify.com/nexgendata/whois-domain-lookup?fpr=2ayu9b) - [SSL Certificate Checker](https://apify.com/nexgendata/ssl-certificate-checker?fpr=2ayu9b) - [Email RBL Bulk Checker](https://apify.com/nexgendata/email-rbl-checker?fpr=2ayu9b) - [Email DMARC Auditor](https://apify.com/nexgendata/email-dmarc-auditor?fpr=2ayu9b) ### Try it [🌐 DNS Propagation Checker on Apify](https://apify.com/nexgendata/dns-propagation-checker?fpr=2ayu9b) New to Apify? [Get free platform credits](https://www.apify.com/?fpr=2ayu9b). ### 💻 Code Example — Python ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("nexgendata/dns-propagation-checker").call(run_input={ ## Fill in the input shape from the actor's input_schema }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) ``` ### 🌐 Code Example — cURL ```bash curl -X POST "https://api.apify.com/v2/acts/nexgendata~dns-propagation-checker/run-sync-get-dataset-items?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ /* input schema */ }' ``` ### ❓ FAQ **Q: How do I get started?** Sign up at [apify.com](https://www.apify.com/?fpr=2ayu9b), grab your API token from Settings → Integrations, and run the actor via the Apify console, API, Python SDK, or any integration (Zapier, Make.com, n8n). **Q: What's the typical cost per run?** See the pricing section below. Most runs finish under $0.10 for typical batches. **Q: Is this actor maintained?** Yes. NexGenData maintains 165+ Apify actors and ships updates regularly. Bug reports via the Apify console issues tab get responses within 24 hours. **Q: Can I use the output commercially?** Yes — you own the output data. Check the target site's Terms of Service for any usage restrictions on the scraped content itself. **Q: How do I handle rate limits?** Apify manages concurrency and retries automatically. For very large batches (10K+ items), run multiple smaller jobs in parallel instead of one mega-job for better reliability. ### 💰 Pricing Pay-per-event pricing — you only pay for what you actually extract. - **Actor Start:** $0.0001 - **result:** $0.0050 ### 🔗 Related NexGenData Actors - [Hacker News Scraper](https://apify.com/nexgendata/hacker-news-scraper?fpr=2ayu9b) - [Google Maps Lead Scraper](https://apify.com/nexgendata/google-maps-scraper?fpr=2ayu9b) - [SEC EDGAR Scraper](https://apify.com/nexgendata/sec-edgar-scraper?fpr=2ayu9b) ### 🚀 Apify Affiliate Program New to Apify? Sign up with our [referral link](https://www.apify.com/?fpr=2ayu9b) — you get free platform credits on signup, and you help fund the maintenance of this actor fleet. ### 📚 More From NexGenData Explore the full catalog, tutorials, Gumroad data packs, and newsletter at **[thenextgennexus.com](https://thenextgennexus.com)** — the brand home for everything we ship. - 📖 Tutorials & how-to guides - 🗂️ Full actor catalog with usage examples - 📦 Gumroad data packs (one-time purchases) - 📬 Newsletter — monthly drops of new actors and revenue experiments *** *Built and maintained by [NexGenData](https://apify.com/nexgendata?fpr=2ayu9b) — 165+ actors covering scraping, enrichment, MCP servers, and automation.* 🏠 Home: [thenextgennexus.com](https://thenextgennexus.com) # Actor input Schema ## `domains` (type: `array`): List of domains to check. Up to 500 per run recommended. ## `recordTypes` (type: `array`): DNS record types to query. Common choices: A (IPv4), AAAA (IPv6), MX (mail), TXT (SPF/DKIM/DMARC), NS (nameservers), CNAME, SOA, CAA. ## Actor input object example ```json { "domains": [ "example.com", "github.com" ], "recordTypes": [ "A" ] } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "domains": [ "example.com", "github.com" ], "recordTypes": [ "A" ] }; // Run the Actor and wait for it to finish const run = await client.actor("nexgendata/dns-propagation-checker").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "domains": [ "example.com", "github.com", ], "recordTypes": ["A"], } # Run the Actor and wait for it to finish run = client.actor("nexgendata/dns-propagation-checker").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "domains": [ "example.com", "github.com" ], "recordTypes": [ "A" ] }' | apify call nexgendata/dns-propagation-checker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nexgendata/dns-propagation-checker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "🌐 DNS Propagation Checker — Global Resolver Bulk Tool", "description": "Check DNS propagation across 15 global resolvers (Google, Cloudflare, Quad9, OpenDNS, Verisign, Yandex). Detects inconsistency, reports by-region variance, returns TTL and full record data.", "version": "0.0", "x-build-id": "cpDhAjBh8KV5aQPoD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~dns-propagation-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-dns-propagation-checker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/nexgendata~dns-propagation-checker/runs": { "post": { "operationId": "runs-sync-nexgendata-dns-propagation-checker", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/nexgendata~dns-propagation-checker/run-sync": { "post": { "operationId": "run-sync-nexgendata-dns-propagation-checker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "domains" ], "properties": { "domains": { "title": "Domains to check", "type": "array", "description": "List of domains to check. Up to 500 per run recommended.", "items": { "type": "string" } }, "recordTypes": { "title": "Record types", "type": "array", "description": "DNS record types to query. Common choices: A (IPv4), AAAA (IPv6), MX (mail), TXT (SPF/DKIM/DMARC), NS (nameservers), CNAME, SOA, CAA.", "default": [ "A" ], "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```