DataSiteAnchorTextList

Search API documentation

⌘K

Use this endpoint to get data about anchor text used to link to a specified site. This can be helpful when trying to understand how people are linking to and talking about your brand. Additionally, this information can be used for topic research to identify clusters or trends in how people are talking about (or linking to) particular sites. The data pulled from this endpoint is similar to the data seen in the Anchor Text section of Link Explorer but does not include the Top Links noted in the web app.

JSON-RPC Method:

data.site.anchor-text.list

Go to Example Code

Request

site_query

object

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

offset

object

Defines the input parameters used to retrieve anchor text data for a given target. It allows controlling the pagination, and number of results returned.

1{
2  "site_query": {
3    "query": "moz.com",
4    "scope": "domain"
5  },
6  "offset": {
7    "limit": 1
8  }
9}

Response

site_query

object

Represents a parsed site query.

offset

object

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

anchor_texts

array

text

string

The anchor text of the link, after normalization. The steps used for normalization are: strip HTML tags, remove leading and trailing whitespace, replace whitespace between words with a single space, and drop all letters to lowercase. To request links with no anchor text, set this parameter to a single null character ("\u0000").

external_root_domains

number

The number of unique root domains linking to target with this anchor text.

external_pages

number

The number of unique pages from a different root domain linking to target with this anchor text.

1{
2  "site_query": {
3    "query": "https://moz.com",
4    "scope": "domain",
5    "original_site_query": {
6      "query": "moz.com",
7      "scope": "domain"
8    },
9    "site_query_suggestion": null
10  },
11  "offset": {
12    "provided_token": null,
13    "token": "IIkQVg4s9ak8aiQ+800Sb3BlbiBzaXRlIGV4cGxvcmVy9+HnUO36uaM=",
14    "limit": 1
15  },
16  "anchor_texts": [
17    {
18      "text": "moz",
19      "external_root_domains": 31377,
20      "external_pages": 776762
21    }
22  ]
23}

Example Code

Quota Usage

Uses one row per returned result.

api.limits.data.rows