Actions30
- AI Optimization Actions
- Backlink Actions
- Business Data Actions
- Keywords Data Actions
- Labs Actions
- On Page Actions
- SERP Actions
Backlink → Get Backlinks
AI-generatedSummary
Fetch backlinks for a specified domain, subdomain, or URL with customizable retrieval mode, filtering, sorting, and pagination options.
Inputs
- Target (Domain, Subdomain, URL) (required) — Domain, subdomain, or webpage URL to retrieve backlink data for. Domains or subdomains should be specified without 'https://' and 'www.'. Pages should be specified with the absolute URL including 'http://' or 'https://'.
- Mode — The backlink retrieval mode determining result granularity: 'As Is' returns all backlinks, 'One Per Domain' returns one backlink per domain, and 'One Per Anchor' returns one backlink per anchor text.
- Limit (up to 1000) — Maximum number of backlink results to return; recommended default is 100.
- Offset — Number of results to skip for pagination.
- Sort — Up to three sorting rules that order results by backlink rank, spam score, or referring domain/page rank in ascending or descending order.
- Backlink Status — Filter backlinks by status: All, Live, or Lost.
- Include Subdomains (required) — Include backlinks from subdomains of the target.
- Include Indirect Links (required) — Include indirect backlinks in the results.
- Filters — Additional filtering parameters as a JSON array per DataForSEO API documentation to refine backlink results.
Output shape
a single JSON object containing the list of retrieved backlinks and associated metadata
The output conforms to DataForSEO's backlink data structure. Pagination is controlled using 'Limit' and 'Offset'. Sorting supports up to three simultaneous rules. Filters must be provided as a valid JSON array string. The operation fetches live backlink data asynchronously and returns the full response from the API.