Link Status
Frequently Asked Questions
What's Covered?
In this guide you’ll learn more about making API calls to the Link Status endpoint for the Links API V2.
Use this endpoint to get information about links from many sources to a single target.
This documentation specifies information for Moz Links API V2. V1 of the Links API does not include a Link Status endpoint.
Please note: This is a weighted endpoint which means that data returned from this endpoint will count as more than 1 row consumed when data is requested. Please see here for more information on weighted endpoints.
Quick Links
Getting Started
Before making calls to the Link Status endpoint, be sure you are set up with an Access ID and Secret Key within your Moz Account.
Just a reminder - the Links API V2 supports Basic Auth in which you are able to use your Access ID as a username and and your Secret Key as a password.
All requests and responses are structured in JSON.
Endpoint Location
When requesting link status data from Links V2, be sure to use the following endpoint.
https://lsapi.seomoz.com/v2/link_status
Request Syntax
{
"sources": ["string"],
"target": "string",
"source_scope": "string",
"target_scope": "string"
}
Example JSON Request
{
"target": "moz.com/blog",
"sources": ["twitter.com", "linkedin.com"],
"source_scope": "root_domain",
"target_scope": "page"
}
Request Parameters
"sources" - Up to 50 sources to get information about.
- Type: Array of string objects
- Required: yes
"target" - Get information about links to this target.
- Type: string
- Required: yes
"target_scope" - Consider links to 'target' at this scope. The default value is 'page'.
- Type: string
- Required: no
- Valid Values: page, subdomain, root_domain
"source_scope" - Consider links from each source at this scope. The default value is 'page'.
- Type: string
- Required: no
- Valid Values: page, subdomain, root_domain
Response Syntax
{
"exists": [boolean]
}
Example JSON Response
{
"exists": [
false,
true
]
}
Response Elements
"exists" - An array of values aligning with request parameter 'sources', with each value indicating whether or not there is a link from that source to the target (given the requested source and target scopes).
- Type: Array of boolean values
Limits
None (information about any link in the index can be queried, even if that link is not present in other endpoints)
Errors
See the Common Errors section for errors that are common to all endpoints.
Example HTTP Request
POST /v2/link_status
Host: lsapi.seomoz.com
Content-Length: [length of request payload in bytes]
User-Agent: [user agent string]
Authorization: Basic [credentials]
{
"target": "moz.com/blog",
"sources": ["google.com%2Finsights", "facebook.com"],
"source_scope": "root_domain",
"target_scope": "page"
}
Example cURL Request
curl -d '{"target": "moz.com/blog","sources": ["twitter.com", "linkedin.com"], "source_scope": "root_domain", "target_scope": "page"}' -X POST https://lsapi.seomoz.com/v2/link_status -u 'access_id:secret_key'
Example Python Request
import requests
auth = (access_id, secret_key)
url = "https://lsapi.seomoz.com/v2/link_status"
data = """{
"target": "moz.com/blog",
"sources": ["twitter.com", "linkedin.com"],
"source_scope": "root_domain",
"target_scope": "page"
}"""
request = requests.post(url, data=data, auth=auth)
Related Articles
Was this article helpful?
Yes! Amazing!
Yes! It was what I needed.
Meh. It wasn’t really what I was looking for.
No, it wasn’t helpful at all.
Thanks for the feedback.