---
title: Collect broken backlinks with DataForSEO
description: Bound a Backlinks Live read by target, page cap, deadline, and provider cost evidence.
---

Use DataForSEO when a task needs broken external-link evidence for one site. The supported capability calls Backlinks Live, keeps cursor pagination sequential, and returns normalized rows plus per-request and total provider cost.

```ts
const audit = await runDataForSeoBacklinkTutorial(resolvedToken, {
  deadlineAt,
  pageCap: 3,
  target: "example.com",
});
```

The caller resolves the organization-wide logical capability before invoking the connector. Pass only the dashboard-provided Base64 `login:password` token, without a `Basic ` prefix. Do not pass the logical handle or a secret-backend locator into the provider package.

Set a page cap for every run. Add a deadline when the task has a bounded execution window. A provider rejection, deadline, or schema drift throws a sanitized error. Retry a rate limit only within the deadline. Treat `pageCapReached: true` as a partial acquisition and keep the returned cost evidence.

Detailed release-source tutorial: [DataForSEO broken-backlink audit](https://github.com/patronage/paitronage/blob/main/src/packages/dataforseo/examples/broken-backlink-audit.ts).

DataForSEO is currently private and named `@paitronage/dataforseo`, so the public-release generator does not mirror it. The source tutorial is ready, but there is no truthful public-mirror link until release eligibility and the consumer import are changed together.