{
  "openapi": "3.0.1",
  "info": {
    "title": "Backlink Checker",
    "description": "[$7.20/1K on Bronze] Check backlinks of any domain or URL: linking page, anchor text, dofollow, domain rank, spam score, first and last seen, new and lost links. Also referring domains, anchor text profile and link gap (sites linking to competitors, not you). Errors free.",
    "version": "0.1",
    "x-build-id": "elNGvcI4mdxYf3DCv"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/blueskyscraper~backlink-checker/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-blueskyscraper-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/blueskyscraper~backlink-checker/runs": {
      "post": {
        "operationId": "runs-sync-blueskyscraper-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/blueskyscraper~backlink-checker/run-sync": {
      "post": {
        "operationId": "run-sync-blueskyscraper-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",
        "properties": {
          "mode": {
            "title": "🔗 What to get",
            "enum": [
              "backlinks",
              "referring-domains",
              "anchors",
              "link-gap"
            ],
            "type": "string",
            "description": "Choose the table you need. <b>Backlinks</b>: one row per link with source URL, anchor, dofollow, domain rank and first/last seen. <b>Referring domains</b>: one row per domain linking to the target. <b>Anchors</b>: one row per anchor text. <b>Link gap</b>: one row per domain that links to your competitors but not to the sites in Targets.",
            "default": "backlinks"
          },
          "targets": {
            "title": "🌐 Targets (domain or page URL)",
            "type": "array",
            "description": "Enter one domain, subdomain or page URL per line. example.com and www.example.com are checked as the whole domain; https://example.com/blog/post is checked as that one page. In <b>Link gap</b> mode, enter your own site(s) here (up to 10): domains that already link to them are left out.",
            "default": [
              "ahrefs.com"
            ],
            "items": {
              "type": "string"
            }
          },
          "competitors": {
            "title": "🥊 Competitors (link gap only)",
            "type": "array",
            "description": "Link gap mode only: enter competitor domains or page URLs, one per line (up to 10 with match = any, up to 20 with match = all). The result lists domains linking to them, flagged with which competitors each one links to.",
            "items": {
              "type": "string"
            }
          },
          "maxRows": {
            "title": "💯 Max rows per target",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Set the most rows to return per target (up to 10,000). In link gap mode with match = any, the limit applies per competitor. Every row is billed, so start small; 30 or more rows per target keeps each data request efficient.",
            "default": 30
          },
          "grouping": {
            "title": "Backlinks: links per domain",
            "enum": [
              "one_per_domain",
              "as_is",
              "one_per_anchor"
            ],
            "type": "string",
            "description": "Backlinks mode only: choose how links are grouped. 'One link per referring domain' returns the strongest link of each linking domain and counts the rest in linksFromDomain.",
            "default": "one_per_domain"
          },
          "dofollowOnly": {
            "title": "Dofollow links only",
            "type": "boolean",
            "description": "Keep only dofollow links (the ones that pass ranking value). In referring domains, anchors and link gap mode, only dofollow links are counted. Switch off to include nofollow, ugc and sponsored links.",
            "default": true
          },
          "minDomainRank": {
            "title": "Minimum domain rank of the linking site (0–100)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Keep only links from domains whose domain rank (0–100, the index's own PageRank-style score) is at least this number. Applies to links in every mode. Leave empty to keep all."
          },
          "onlyNewDays": {
            "title": "Only new in the last N days",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Keep only links first seen in the last N days (for referring domains and anchors: domains or anchors first seen in that window). Leave empty for all dates."
          },
          "excludeLost": {
            "title": "Live links only (exclude lost)",
            "type": "boolean",
            "description": "Keep only links found on the last crawl. Switch off to also return lost links (removed links or pages), flagged with isLost / lostDate.",
            "default": true
          },
          "linkGapMatch": {
            "title": "Link gap: competitors to match",
            "enum": [
              "any",
              "all"
            ],
            "type": "string",
            "description": "Link gap mode only. 'Any' finds every domain that links to at least one competitor and flags which ones. 'All' finds only the domains linking to every competitor — the warmest prospects.",
            "default": "any"
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "strongest",
              "newest"
            ],
            "type": "string",
            "description": "Choose which rows come first and are kept when Max rows cuts the list: the strongest links/domains (by rank; anchors by number of referring domains) or the most recently found.",
            "default": "strongest"
          },
          "includeSubdomains": {
            "title": "Include subdomains of the target",
            "type": "boolean",
            "description": "Count links pointing to every subdomain of a domain target (blog., shop., …). Switch off to check only the exact host you entered. Ignored for page URLs.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}