Link Intersect

In this guide you’ll learn more about making API calls to the Link Intersect endpoint for the Links API V2.

This documentation specifies information for Moz Links API V2. V1 of the Links API does not include a Link Intersect endpoint.

What is this endpoint for?

The Link Intersect endpoint will return data about sites that are linking to your competitors, but not to you. This is a clever way to explore your competitors’ backlink profile, and gives you some helpful ideas about which sites you may want to reach out to when performing your link building outreach. The endpoint works by providing a list of sources that link to at least one of a list of positive targets and don't link to any of a list of negative targets. The data for this endpoint is similar to what is returned in the Link Intersect section of Link Explorer.

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
• Endpoint Location
• Request Syntax
• Example JSON Request
• Request Parameters
• Response Syntax
• Example JSON Response
• Response Elements
• Limits
• Errors
• Example HTTP Request
• Example cURL Request
• Example Python Request

Before making calls to the Link Intersect 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.

• Learn more about how to get a key
• Learn more about Moz Links API authentication
• Learn more about weighted endpoints

When requesting Link Intersect data from Links V2, be sure to use the following endpoint.

• Use Postman? Access the Links API V2 Postman Collection

"positive_targets" - Get sources that link to at least one of these positive targets. Up to 6 total targets may be specified in the 'positive_targets' and 'negative_targets' fields (combined).

• Type: Array of Map objects
• Required: yes
• When indicating “positive_targets”:
  • "target" - The url for this target.
    • Type: string
      
    • Required: yes
  • "scope" - Find sources that link to 'target' at this scope.
    • Type: string
    • Required: yes

"negative_targets" - Get sources that don't link to any of these negative targets. Up to 6 total targets may be specified in the 'positive_targets' and 'negative_targets' fields (combined).

• Type: Array of string objects
• Required: no
• When indicating “negative_targets”:
  • "target" - The url for this target.
    • Type: string
    • Required: yes
  • "scope" - Find sources that don't link to 'target' at this scope.
    • Type: string
    • Required: yes

"min_matching_targets" - If set, only results that match at least this many positive targets will be returned.

• Type: number
• Required: no

"source_scope" - The scope of sources to return. The default value is 'page'.

• Type: string
• Required: no
• Valid Values: page, root_domain

"sort" - The order to return results in. Results are returned in descending order (higher values first). The default value is 'matching_target_count'.

• Type: string
• Required: no
• Valid Values: source_domain_authority, source_spam_score, matching_target_count

"limit" - Only return up to this number of results. The default value is 25.

• Type: number
• Required: no
• Valid Values: 1-50

"next_token" - If set, return the next set of results from a previous request whose 'next_token' element equals this value.

• Type: string
• Required: no

"results"- An array of sources that satisfy the request.

• Type: Array of Map objects
• Within “results” the following response elements exist:
  • "page" - The url of the source, after canonicalization.
    • Type: string
  • "title" - If the 'source_scope' request parameter is 'page', the title of the source page seen the most recent time it has been crawled. If the 'source_scope' request parameter is 'root_domain', this element will always be blank.
    • Type: string
  • "domain_authority" - A score from 1 to 100 representing the likelihood that the source root domain will rank well in search engine result pages.
    • Type: number
  • "spam_score" - The spam score for the source, or -1 if a spam score does not exist for that source.
    • Type: number
  • "matching_target_indexes" - An array of indexes into the 'positive_targets' request parameter, with one entry for each positive target this source links to. The values in this array are sorted in ascending numeric order.
    • Type: Array of numbers
  • "matching_source_pages" - If request parameter 'source_scope' is set to 'root_domain', this element aligns with the 'matching_target_indexes' field and contains the highest page-authority URL from this source that links to each target. If request parameter 'source_scope' is set to 'page', this element will be empty.
    • Type: Array of Map objects
    • Within “matching_source_pages” the following response elements exist:
      • "page" - The source page, after canonicalization.
        • Type: string
      • "page_authority" - A score from 1 to 100 representing the likelihood that this page will rank well in search engine result pages.
        • Type: number

"next_token" - If non-empty, the number of results was limited by the 'limit' parameter, and the next set of results can be obtained by repeating the request with the 'next_token' request parameter set to this value.

• Type: string

• Up to 500 results for all types of queries. (50 per request)
• For queries including positive and/or negative targets with more than 100,000 linking pages, some low-quality sources may not be returned.

See the Common Errors section for errors that are common to all endpoints.