{
  "openapi": "3.0.1",
  "info": {
    "title": "Backlink Checker: Ahrefs & Semrush Alternative, Bulk Domains",
    "description": "Check up to 10,000 domains in one run: domain rank 0-100, backlinks, referring domains, spam score, estimated traffic and ranked keywords from DataForSEO. Bulk price from $1.70 per 1,000 domains. Optional backlink and keyword lists, gained and lost backlinks watch, webhook.",
    "version": "0.1",
    "x-build-id": "FDpaPwzg5Vim53pYs"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/alexmorain~seo-backlinks-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-alexmorain-seo-backlinks-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/alexmorain~seo-backlinks-scraper/runs": {
      "post": {
        "operationId": "runs-sync-alexmorain-seo-backlinks-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/alexmorain~seo-backlinks-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-alexmorain-seo-backlinks-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 or URLs",
            "type": "array",
            "description": "One domain or URL per line, up to 10,000 distinct targets. <code>www.apify.com</code> and <code>https://apify.com/store</code> are both read as <code>apify.com</code> in the default target mode, so every row counts the whole site. Duplicates are removed. A line that is not a valid domain comes back as an <code>invalid_input</code> row and is not charged.",
            "items": {
              "type": "string"
            }
          },
          "targetMode": {
            "title": "Target mode",
            "enum": [
              "domain",
              "exact"
            ],
            "type": "string",
            "description": "<b>Registered domain</b> (default): the whole site, subdomains included, whatever form you paste. <b>Exact</b>: the host or URL exactly as written, for one subdomain or one page (<code>https://example.com/blog/</code>). Traffic and ranked keywords are not available for a page URL, its row says so.",
            "default": "domain"
          },
          "includeTraffic": {
            "title": "Estimated organic traffic",
            "type": "boolean",
            "description": "Adds the estimated monthly organic traffic and the number of keywords the domain ranks for. One extra DataForSEO call per 1,000 domains.",
            "default": true
          },
          "trafficCountry": {
            "title": "Traffic country",
            "enum": [
              "",
              "us",
              "gb",
              "ca",
              "au",
              "ie",
              "nz",
              "in",
              "fr",
              "de",
              "es",
              "it",
              "nl",
              "be",
              "pt",
              "br",
              "mx",
              "jp",
              "ch",
              "se",
              "pl"
            ],
            "type": "string",
            "description": "Country for the traffic estimate and keyword count. <b>Worldwide</b> counts every country (about 2.4 times more keywords than the US alone for apify.com). The choice is written in every row.",
            "default": ""
          },
          "includeBacklinks": {
            "title": "Backlink list",
            "type": "boolean",
            "description": "One extra row per backlink (source page, anchor text, follow flag, ranks, first and last seen). Charged per backlink, plus a small fee per domain.",
            "default": false
          },
          "maxBacklinksPerDomain": {
            "title": "Max backlinks per domain",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Upper limit of backlink rows for each domain.",
            "default": 100
          },
          "backlinksMode": {
            "title": "Backlink list mode",
            "enum": [
              "one_per_domain",
              "as_is"
            ],
            "type": "string",
            "description": "<b>One per referring domain</b> (default): the best link of each site that links to you. <b>All links</b>: every link, several per site.",
            "default": "one_per_domain"
          },
          "dofollowOnly": {
            "title": "Dofollow links only",
            "type": "boolean",
            "description": "Leaves out nofollow links in the backlink list.",
            "default": false
          },
          "includeRankedKeywords": {
            "title": "Ranked keywords list",
            "type": "boolean",
            "description": "One extra row per keyword the domain ranks for in Google, best search volume first: position, ranked URL, search volume, CPC, competition, difficulty, estimated traffic. Not available for page URLs.",
            "default": false
          },
          "maxKeywordsPerDomain": {
            "title": "Max keywords per domain",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Upper limit of keyword rows for each domain.",
            "default": 100
          },
          "keywordsCountry": {
            "title": "Keywords country",
            "enum": [
              "",
              "us",
              "gb",
              "ca",
              "au",
              "ie",
              "nz",
              "in",
              "fr",
              "de",
              "es",
              "it",
              "nl",
              "be",
              "pt",
              "br",
              "mx",
              "jp",
              "ch",
              "se",
              "pl"
            ],
            "type": "string",
            "description": "Country of the keyword rankings. Default United States.",
            "default": "us"
          },
          "monitor": {
            "title": "Watch gained and lost backlinks",
            "type": "boolean",
            "description": "Adds the number of new and lost backlinks and referring domains since the last check. With the backlink list on, delivers the new and the lost links too, and <b>never delivers the same link twice</b>: schedule the Actor and only pay for what changed. The memory is kept in a named store, <code>seo-backlinks-monitor</code>, in your account. Counters count links; with the default backlink list mode (one per referring domain) the lists count domains, so they are shorter: choose <i>All links</i> to get as many rows as the counters announce (measured on apify.com: 130,433 announced, 130,454 listed). <b>Billing:</b> in a watch each page of up to 1,000 backlink rows <i>read</i> bills one backlink list fee, because pages made of links you already received are read but not delivered. The reading stops at the first page made only of known links.",
            "default": false
          },
          "monitorName": {
            "title": "Watch name",
            "type": "string",
            "description": "Name of the memory. Leave empty to derive it from the list of domains and the options: same list and options, same memory. Use a name to keep one watch when the list changes.",
            "default": ""
          },
          "monitorLookbackDays": {
            "title": "First check: look back (days)",
            "minimum": 1,
            "maximum": 90,
            "type": "integer",
            "description": "How far back the very first check of a watch looks. Later checks start from the previous check.",
            "default": 30
          },
          "fullProfile": {
            "title": "Full profile for every domain",
            "type": "boolean",
            "description": "Reads every domain through the detailed route, even in a large list, to fill the full-profile fields: first seen, dofollow share, referring pages, IPs and subnets, broken links, server country and CMS, and the breakdowns by TLD, country, link type, attribute, platform and placement. Charged as <b>Domain (1 to 3 domains)</b> for each domain instead of a batch fee. Runs in chunks of 50 domains. Needs the current price list to include the trends event, otherwise it is ignored with a warning and nothing extra is charged.",
            "default": false
          },
          "includeTrends": {
            "title": "Gained and lost over time",
            "type": "boolean",
            "description": "Adds two series for each domain: backlinks and referring domains gained and lost per period, and rank, backlinks and referring domains over time (<code>trendNewLost</code>, <code>trendHistory</code>), plus the referring domains gained and lost over the period. Charged once per domain whose two series were read, never on an error. Needs the current price list to include the trends event, otherwise it is ignored with a warning and nothing is charged.",
            "default": false
          },
          "trendsGroupRange": {
            "title": "Trends period",
            "enum": [
              "day",
              "week",
              "month"
            ],
            "type": "string",
            "description": "One point per <b>day</b> (default window 90 days, at most 366), <b>week</b> (default 2 years, at most 5 years) or <b>month</b> (default: full history since 2019). The last point of a month is dated at the end of the month, even if it is not over.",
            "default": "month"
          },
          "trendsDateFrom": {
            "title": "Trends start date",
            "type": "string",
            "description": "Optional, <code>YYYY-MM-DD</code>, not before 2019-01-30. Leave empty for the default window of the chosen period. With day or week points the date cannot go further back than 366 days or 5 years.",
            "default": ""
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "Optional. The run summary is sent there by POST when the run ends (Slack, Discord, Zapier...). The URL is never written to a log."
          },
          "cacheMaxAgeHours": {
            "title": "Reuse identical requests for (hours)",
            "minimum": 0,
            "maximum": 720,
            "type": "integer",
            "description": "A request identical to one already made <b>from your account</b> within this many hours is answered from a cache stored in your account (named key-value store <code>seo-backlinks-cache</code>), with the same data. The backlink index moves daily, so the default is 3 days. Set to <code>0</code> to always fetch fresh data. The cache is off when <b>Monitor</b> is on.",
            "default": 72
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}