DataForSEO · Backlinks
dataforseo/backlinks/listGet 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
| Field | Kind | Default | Description |
|---|---|---|---|
target required | text | — | Domain or subdomain without https:// or www., or an absolute page URL with https://. |
mode | one of as_is, one_per_domain, one_per_anchor | — | as_is (default) for every backlink, one_per_domain, or one_per_anchor. |
limit | number 1 to 1000 | 100 | Rows to return, 1 to 1000. Each row costs $0.000036. Omitted, 100 is sent. |
offset | number 0 to 20000 | — | Rows to skip, up to 20,000. Use search_after_token past that. |
filters | text | — | JSON array of filter conditions in the DataForSEO syntax, at most 8, such as ["keyword_info.search_volume",">",100]. |
order_by | list | — | Up to 3 sorting rules, each field,direction, such as keyword_info.search_volume,desc. |
rank_scale | one of one_hundred, one_thousand | — | Rank scale, one_hundred or one_thousand (default). |
custom_mode | JSON | — | Backlinks per field, such as {"field":"domain_from","value":10}. Overrides mode. |
include_subdomains | true or false | — | Count links to subdomains of the target. Default true. |
search_after_token | text | — | Token from the previous response, for results past 20,000. |
backlinks_status_type | one of all, live, lost | — | live (default) counts backlinks seen on the last check, lost counts removed ones, all counts both. |
exclude_internal_backlinks | true 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.