{ "openapi": "3.0.1", "info": { "title": "Ahrefs DR Checker & API: Bulk Domain Rating & Traffic", "description": "Check Ahrefs Domain Rating (DR), referring domains, backlinks and organic traffic for thousands of domains at once: traffic value, keywords, top countries, top keywords, competitors, 12-month history. Tracks DR and traffic changes between runs. Works on the free Apify plan.", "version": "0.1", "x-build-id": "TO8iogTRuc95or2Ow" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s_actors~ahrefs-dr-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s_actors-ahrefs-dr-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/s_actors~ahrefs-dr-checker/runs": { "post": { "operationId": "runs-sync-s_actors-ahrefs-dr-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/s_actors~ahrefs-dr-checker/run-sync": { "post": { "operationId": "run-sync-s_actors-ahrefs-dr-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", "properties": { "domains": { "title": "🌐 Domains or website URLs", "type": "array", "description": "One domain or website URL per line (ahrefs.com, https://www.example.com/page). URLs are reduced to the domain, www. is dropped, duplicates are checked once. Up to 10,000 per run. Ahrefs counts the domain with all its subdomains.", "items": { "type": "string" } }, "liveCheck": { "title": "⚡ Live check on Ahrefs", "enum": [ "missing", "always", "never" ], "type": "string", "description": "Popular sites come from the Ahrefs Top index: fast and cheap. Other domains are checked live in Ahrefs' own free tools, which adds the \"Live check\" charge per domain. \"For every domain\" also adds the total backlinks count and dofollow share to indexed sites.", "default": "missing" }, "liveTraffic": { "title": "📈 Organic traffic for live-checked domains", "type": "boolean", "description": "Domains missing from the index get their organic traffic, traffic value, top pages, countries and keywords from a second live check (one more \"Live check\" charge). Turn off when you only need DR.", "default": true }, "trackChanges": { "title": "🔔 Track changes between runs", "type": "boolean", "description": "Remember each domain's DR, referring domains and traffic and add the change since the previous run with the same tracker name. Schedule the Actor (daily or weekly) to monitor your site, competitors or link prospects.", "default": false }, "onlyChanged": { "title": "Return only changed domains", "type": "boolean", "description": "With tracking on: return (and pay for) only domains whose DR, referring domains or traffic changed since the previous run, plus new domains.", "default": false }, "monitorName": { "title": "Tracker name", "type": "string", "description": "Separate trackers for separate domain lists, e.g. \"my-sites\" and \"competitors\".", "default": "default" }, "includeHistory": { "title": "🗓️ Include 12-month history", "type": "boolean", "description": "Monthly organic traffic, traffic value and referring domains for the last 12 months (6 months of traffic for live-checked domains).", "default": true }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Log every request retry.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }