DataForSEO · Referring domains
dataforseo/backlinks/referring-domainsGet SEO and search ranking data with DataForSEO · Referring domains from Alexandria through one Spiral API key. Domains that link to a target, one row each with its rank, backlink count, spam score, and first seen date. 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://. |
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 … | — | Items to skip, for the next page. Default 0. |
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). |
backlinks_filters | text | — | JSON array of conditions on the backlinks counted, in the DataForSEO filter syntax, at most 8, such as ["dofollow","=",true]. |
include_subdomains | true or false | — | Count links to subdomains of the target. Default true. |
internal_list_limit | number 1 to 1000 | — | Entries kept in the referring_links_* breakdowns. Default 10. |
backlinks_status_type | one of all, live, lost | — | live (default) counts backlinks seen on the last check, lost counts removed ones, all counts both. |
include_indirect_links | true or false | — | Count links that reach the target through a redirect or canonical. Default true. |
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/referring-domains",
"input": {
"target": "<target>"
}
}'Frequently asked questions
How much does DataForSEO · Referring domains 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 · Referring domains through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "dataforseo/backlinks/referring-domains"` 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 · Referring domains?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use DataForSEO · Referring domains?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.