{ "openapi": "3.0.1", "info": { "title": "DNS Records Scraper: Bulk Lookups over DoH", "description": "Resolve DNS records in bulk over DNS-over-HTTPS: A, AAAA, MX, TXT, NS, CNAME, SOA, CAA and SPF/DMARC. No local resolver to configure, and a run-wide lookup cap you set.", "version": "0.0", "x-build-id": "jiK7PAuxE6UptNy8o" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arman-bd~dns-records-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arman-bd-dns-records-scraper", "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/arman-bd~dns-records-scraper/runs": { "post": { "operationId": "runs-sync-arman-bd-dns-records-scraper", "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/arman-bd~dns-records-scraper/run-sync": { "post": { "operationId": "run-sync-arman-bd-dns-records-scraper", "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", "type": "array", "description": "Hostnames to resolve. Paste them however you have them. 'apify.com', 'https://apify.com/store' and 'user@apify.com' all normalise to 'apify.com'. Sub-domains work as written, so 'mail.apify.com' resolves the sub-domain, not the apex.", "items": { "type": "string" } }, "recordTypes": { "title": "Record types", "type": "array", "description": "Which record types to look up for every domain. Each one is a separate lookup and a separate dataset item. A, MX and TXT cover most audits; add CAA to see which certificate authorities are permitted, and SOA to identify the authoritative zone.", "items": { "type": "string", "enum": [ "A", "AAAA", "MX", "TXT", "NS", "CNAME", "SOA", "CAA" ], "enumTitles": [ "A: IPv4 address", "AAAA: IPv6 address", "MX: mail exchangers", "TXT: text records (SPF, verification tokens)", "NS: authoritative nameservers", "CNAME: canonical name alias", "SOA: start of authority", "CAA: certificate authority authorisation" ] }, "default": [ "A", "AAAA", "MX", "TXT", "NS" ] }, "resolver": { "title": "Resolver", "enum": [ "google", "cloudflare" ], "type": "string", "description": "Which DNS-over-HTTPS provider answers first. The two occasionally disagree because they hit different authoritative caches. If the chosen one fails, the other is tried automatically and every record says which actually answered.", "default": "google" }, "maxLookups": { "title": "Maximum lookups", "minimum": 0, "type": "integer", "description": "Hard ceiling on the number of dataset items the whole run may produce, and therefore on what it costs. One item is one domain and one record type, so 10 domains × 5 record types is 50. Domains are resolved in the order you listed them and the run stops the moment the ceiling is reached; anything left is named in RUN_SUMMARY.domainsSkippedByCap. Set 0 for no ceiling.", "default": 1000 }, "parseEmailPolicy": { "title": "Parse SPF and DMARC", "type": "boolean", "description": "Extract the SPF record from the domain's TXT records and fetch the DMARC record from _dmarc., then decode both policies into readable fields. Adds one lookup per domain and is what makes an email-security audit possible in a single run.", "default": true } } }, "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 } } } } } } } } } }