Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaSEOAvailable now

DataForSEO · Backlinks

dataforseo/backlinks/list

Get SEO and search ranking data with DataForSEO · Backlinks from Alexandria through one Spiral API key. Backlinks pointing to a domain, subdomain, or page: the linking URL and domain, anchor, dofollow, first and last seen, and rank. Use backlinks/referring-domains for one row per linking domain. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

Up to $0.0942786 per run.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
target requiredtext—

Domain or subdomain without https:// or www., or an absolute page URL with https://.

modeone of
as_is, one_per_domain, one_per_anchor
—

as_is (default) for every backlink, one_per_domain, or one_per_anchor.

limitnumber
1 to 1000
100

Rows to return, 1 to 1000. Each row costs $0.000036. Omitted, 100 is sent.

offsetnumber
0 to 20000
—

Rows to skip, up to 20,000. Use search_after_token past that.

filterstext—

JSON array of filter conditions in the DataForSEO syntax, at most 8, such as ["keyword_info.search_volume",">",100].

order_bylist—

Up to 3 sorting rules, each field,direction, such as keyword_info.search_volume,desc.

rank_scaleone of
one_hundred, one_thousand
—

Rank scale, one_hundred or one_thousand (default).

custom_modeJSON—

Backlinks per field, such as {"field":"domain_from","value":10}. Overrides mode.

include_subdomainstrue or false—

Count links to subdomains of the target. Default true.

search_after_tokentext—

Token from the previous response, for results past 20,000.

backlinks_status_typeone of
all, live, lost
—

live (default) counts backlinks seen on the last check, lost counts removed ones, all counts both.

exclude_internal_backlinkstrue or false—

Drop links from subdomains of the same domain. Default true.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "dataforseo/backlinks/list",
    "input": {
      "target": "<target>"
    }
  }'

Frequently asked questions

How much does DataForSEO · Backlinks cost?

Up to $0.0942786 per run. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use DataForSEO · Backlinks through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "dataforseo/backlinks/list"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use DataForSEO · Backlinks?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use DataForSEO · Backlinks?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.