{ "openapi": "3.0.1", "info": { "title": "Backlink Checker: Referring Domains & Spam Score", "description": "Backlink checker and backlinks API: full backlink lists, referring domains, domain rank, dofollow share and spam score for up to 1,000 domains or URLs per run. $0.03 per domain + $4 per 1,000 backlinks; failed lookups are free.", "version": "1.0", "x-build-id": "SgUQppNbYcoPCBinm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/meridianlabs~backlink-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-meridianlabs-backlink-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/meridianlabs~backlink-checker/runs": { "post": { "operationId": "runs-sync-meridianlabs-backlink-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/meridianlabs~backlink-checker/run-sync": { "post": { "operationId": "run-sync-meridianlabs-backlink-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": [ "targets" ], "properties": { "targets": { "title": "Domains or URLs", "type": "array", "description": "Domains (example.com, includes subdomains) or page URLs (https://example.com/page), one per line, up to 1,000 per run. Duplicates are removed.", "items": { "type": "string" } }, "mode": { "title": "What to return", "enum": [ "summary", "backlinks", "referring_domains" ], "type": "string", "description": "Summary is one row per target. The other two modes add one row per backlink or per referring domain, strongest first (backlinks by link rank, referring domains by domain rank).", "default": "summary" }, "maxRowsPerTarget": { "title": "Max rows per target", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Backlinks / referring domains mode only: the most rows to return for each target (strongest first). Your cost cap: rows are charged individually.", "default": 1000 }, "dofollowOnly": { "title": "Dofollow links only", "type": "boolean", "description": "Backlinks mode: only dofollow links. Referring domains mode: only domains with at least one dofollow link to the target.", "default": false }, "minDomainRank": { "title": "Minimum domain rank (0-1000)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Skip linking domains ranked below this. Rank is DataForSEO's 0-1000 authority score (roughly: 300+ = an established site, 600+ = a major one).", "default": 0 }, "excludeSpamAbove": { "title": "Exclude spam score above (0-100)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Optional. Leave empty to keep everything; 30 is a common cut-off for link audits." }, "failOnErrors": { "title": "Fail the run if any lookup fails", "type": "boolean", "description": "Useful for schedules and monitoring: the run is marked failed if any target errors. Failed lookups are still not charged.", "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 } } } } } } } } } }