DataSiteLinkIntersectFetch

Search API documentation

⌘K

This endpoint returns information about sites that point to two or more specified domains, or that point at some domains but not others. It can be thought of as a Venn diagram or set construction tool for links.

JSON-RPC Method:

data.site.link.intersect.fetch

Go to Example Code

Request

is_linking_to

array

Get sources that link to at least one of the provided sites, or more if minimum_matching_targets is set (see description of minimum_matching_targets below). Up to 6 total targets may be specified in the is_linking_to and not_linking_to fields combined, and at least one target must be specified in is_linking_to.

query

string

A URL to query for.

scope

string

The scope to parse the query with. Providing a less detailed scope than the provided URL will alter the input. e.g. moz.com/foo/bar with a scope of domain will ultimately resolve to moz.com

Acceptable Values:

domainsubdomainsubfolderurl

not_linking_to

array

Optionally, ensure that the returned sources that do not link to any of the provided sites.

query

string

A URL to query for.

scope

string

The scope to parse the query with. Providing a less detailed scope than the provided URL will alter the input. e.g. moz.com/foo/bar with a scope of domain will ultimately resolve to moz.com

Acceptable Values:

domainsubdomainsubfolderurl

options

object

offset

object

Limit and pagination controls. Optionally specify the total number of desired results and, after the first request has been made, access results on the next page of results.

Response

is_linking_to

array

query

string

A URL to query for.

scope

string

The scope to parse the query with. Providing a less detailed scope than the provided URL will alter the input. e.g. moz.com/foo/bar with a scope of domain will ultimately resolve to moz.com

Acceptable Values:

domainsubdomainsubfolderurl

original_site_query

object

A SiteQuery provides a target URL along with a scope to define how the query is parsed.

site_query_suggestion

object | null

Represents a suggestion to the user for a site query in case it is determined that a better option may exist (e.g. due to redirects).

not_linking_to

array

query

string

A URL to query for.

scope

string

The scope to parse the query with. Providing a less detailed scope than the provided URL will alter the input. e.g. moz.com/foo/bar with a scope of domain will ultimately resolve to moz.com

Acceptable Values:

domainsubdomainsubfolderurl

original_site_query

object

A SiteQuery provides a target URL along with a scope to define how the query is parsed.

site_query_suggestion

object | null

Represents a suggestion to the user for a site query in case it is determined that a better option may exist (e.g. due to redirects).

options

object

Echoes back the parameters provided in the original request.

offset

object

Represents the token to provide to get the next set of results, in addition to the token that was provided (if applicable).

link_intersects

array

page

string

The url of the source, after canonicalization.

title

string

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.

domain_authority

number

A score from 1 to 100 representing the likelihood that the source root domain will rank well in search engine result pages.

spam_score

number

The spam score for the source, or -1 if a spam score does not exist for that source

matching_target_indexes

array

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 order.

matching_source_pages

array

page

string

The url of the source, after canonicalization.

page_authority

number

A score from 1 to 100 representing the likelihood that this page will rank well in search engine result pages.

1{
2  "is_linking_to": [
3    {
4      "query": "https://latimes.com",
5      "scope": "domain",
6      "original_site_query": {
7        "query": "latimes.com",
8        "scope": "domain"
9      },
10      "site_query_suggestion": null
11    },
12    {
13      "query": "http://blog.nytimes.com",
14      "scope": "subdomain",
15      "original_site_query": {
16        "query": "http://blog.nytimes.com",
17        "scope": "subdomain"
18      },
19      "site_query_suggestion": null
20    }
21  ],
22  "not_linking_to": [
23    {
24      "query": "https://moz.com",
25      "scope": "domain",
26      "original_site_query": {
27        "query": "moz.com",
28        "scope": "domain"
29      },
30      "site_query_suggestion": null
31    }
32  ],
33  "offset": {
34    "provided_token": null,
35    "token": "ASP+gHcla1GA",
36    "limit": 1
37  },
38  "options": {
39    "minimum_matching_targets": null,
40    "scope": "page",
41    "sort": "matching_target_count"
42  },
43  "link_intersects": [
44    {
45      "page": "www.google.com/amp/www.latimes.com/local/lanow/la-me-ln-aliso-viejo-shooting-20171012-story,amp.html",
46      "title": "",
47      "domain_authority": 100,
48      "spam_score": 8,
49      "matching_target_indexes": [
50        0
51      ]
52    }
53  ]
54}

Example Code

Quota Usage

Uses N quota per result, where N is the total quantity of items in is_linking_to and not_linking_to.

api.limits.data.rows