SEO

Search engine optimization data for agents. Backlink analysis, domain authority, URL metrics, and keyword research.

GET/v1/seo/backlinks

https://api.vee3.io/v1/seo/backlinks

10 tokens

Discover backlinks pointing to a URL with overview stats and a detailed list of linking pages.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_seo_backlinks

Parameters2 fields

urlstringRequired

Public website URL to check for backlinks.

max length 2048

include_subdomainsbooleanRequired

When true (default), include backlinks to the domain and its subdomains. When false, analyze only the exact URL.

Default: true

Response11 fields

overviewobject

4 fields

Aggregate backlink statistics for the target.

domainRatinginteger

Domain authority score for the target.

urlRatinginteger

URL rating for the target.

backlinksinteger

Total backlinks found.

referringDomainsinteger

Number of referring domains.

backlinksarrayitems

5 fields

Individual backlink records with anchor text and source URLs.

anchorstring

Anchor text of the backlink.

domainRatinginteger

Domain rating of the linking page.

titlestring

Title of the linking page.

urlFromstring

URL of the page containing the backlink.

urlTostring

Target URL receiving the backlink.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, seo_not_configured, seo_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/seo/backlinks"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "url": "https://example.com",
    "include_subdomains": True
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample overview and backlink entries (truncated).

sample_backlinks.json

{
  "overview": {
    "domainRating": 80,
    "urlRating": 0,
    "backlinks": 650557,
    "referringDomains": 15965,
    "dofollowBacklinks": {
      "percentage": 84,
      "count": 546468
    },
    "dofollowReferringDomains": {
      "percentage": 85,
      "count": 13570
    }
  },
  "backlinks": [
    {
      "anchor": "example link",
      "domainRating": 97,
      "title": "Example Page",
      "urlFrom": "https://en.wikipedia.org/wiki/Example",
      "urlTo": "https://example.com/page"
    }
  ]
}

GET/v1/seo/keyword-metrics

https://api.vee3.io/v1/seo/keyword-metrics

10 tokens

Research a keyword: search volume, clicks, cost per click, difficulty, global volume, and traffic potential for a target country.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_seo_keyword_metrics

Parameters2 fields

keywordstringRequired

Search keyword or phrase to analyze.

max length 512

countrystringRequired

2-letter ISO country code for the target market (default us). Use list_seo_country_codes for supported values.

Default: "us" · max length 2

Response7 fields

keywordstring

Analyzed keyword.

searchVolumeinteger

Estimated monthly search volume in the selected country.

clicksinteger

Estimated monthly clicks from organic search.

cpcnumber

Estimated cost per click in paid search.

difficultyinteger

Keyword difficulty score (higher is harder to rank).

globalSearchVolumeinteger

Estimated global monthly search volume.

trafficPotentialinteger

Estimated traffic potential if ranking well.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, seo_not_configured, seo_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/seo/keyword-metrics"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "keyword": "fishing",
    "country": "us"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample keyword metrics for fishing.

fishing_metrics.json

{
  "keyword": "fishing",
  "searchVolume": 89000,
  "clicks": 33000,
  "cpc": 0.15,
  "difficulty": 46,
  "globalSearchVolume": 229000,
  "trafficPotential": 6300
}

GET/v1/seo/url-metrics

https://api.vee3.io/v1/seo/url-metrics

10 tokens

Analyze a URL with Ahrefs page-level and domain-level SEO metrics: backlinks, referring domains, traffic estimates, and keyword counts.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_seo_url_metrics

Parameters1 field

urlstringRequired

Public page URL to analyze.

max length 2048

Response10 fields

pageobject

4 fields

Metrics for the requested page URL.

backlinksinteger

Backlinks pointing to the page.

refDomainsinteger

Referring domains for the page.

trafficnumber

Estimated organic traffic for the page.

urlRatinginteger

URL rating score for the page.

domainobject

4 fields

Metrics for the parent domain.

domainRatinginteger

Domain authority score from 0 to 100.

backlinksinteger

Total backlinks for the domain.

refDomainsinteger

Referring domains for the domain.

trafficnumber

Estimated organic traffic for the domain.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, seo_not_configured, seo_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/seo/url-metrics"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "url": "https://example.com"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample page and domain metrics.

example_homepage_metrics.json

{
  "page": {
    "backlinks": 2090614,
    "refDomains": 55636,
    "traffic": 561615.9,
    "trafficValue": 199094.48,
    "organicKeywords": 479,
    "urlRating": 68,
    "numberOfWordsOnPage": 50
  },
  "domain": {
    "domainRating": 94,
    "ahrefsRank": 59,
    "domainRank": 59,
    "backlinks": 685193312,
    "refDomains": 917869,
    "traffic": 31762840,
    "trafficValue": 9057845,
    "organicKeywords": 4243076
  }
}

GET/v1/seo/basic-metrics

https://api.vee3.io/v1/seo/basic-metrics

10 tokens

Look up Ahrefs domain authority signals for a website: domain rating and global rank.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_seo_basic_metrics

Parameters1 field

urlstringRequired

Public website URL to analyze (for example https://example.com).

max length 2048

Response2 fields

domainRatinginteger

Domain authority score from 0 to 100.

ahRankinteger

Global website rank (lower is stronger).

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, seo_not_configured, seo_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/seo/basic-metrics"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "url": "https://example.com"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample domain rating for a high-authority site.

example_com_rating.json

{
  "domainRating": 100,
  "ahRank": 1
}

GET/v1/seo/country-codes

https://api.vee3.io/v1/seo/country-codes

0 tokens

List supported 2-letter country codes for the country parameter on keyword metrics.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

list_seo_country_codes

Parameters0 fields

Response2 fields

country_codesarrayitems

1 field

Supported ISO country codes for keyword metrics.

codestring

2-letter country code.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required

Example request

Python

import requests

url = "https://api.vee3.io/v1/seo/country-codes"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "url": "https://example.com"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample country codes (truncated).

sample_codes.json

[
  "us",
  "gb",
  "de",
  "fr",
  "ca"
]