▣ DATA EXTRACTION · MARKETING

Advanced Domain Analysis API

What it does

Domain Analysis helps you inspect a domain’s organic and paid search footprint, compare competitors, and review keyword-level performance across regions and time.

Send a domain or URL together with a source, and get back structured SEO data for pages, subdomains, rankings, ads, and overview metrics. The endpoints support both current snapshots and historical views, plus worldwide and region-specific breakdowns. You can sort and filter by traffic, keywords, price, position, CPC, difficulty, competition, and intent, depending on the endpoint.

Use Domain Analysis when you need to map a site’s search visibility, find competing domains, or track keyword movement over time. For example, you can pull the pages driving the most traffic, compare keyword overlap between two domains, or inspect paid ads and their snippets for a target keyword or domain.

The responses are designed for direct ingestion into dashboards, reporting pipelines, or internal SEO tooling. You get fields such as url, title, keyword, traffic_sum, keywords_count, price_sum, cpc, volume, position, difficulty, competition, and intent or ranking breakdowns where the endpoint provides them.

▣ ENDPOINT 01 / 10

GET

Get Worldwide URL Overview

https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/overview/worldwide/url

QUICKSTART

GUIDE

Quickstart

Fetch a worldwide domain overview for a URL by passing the target URL as a query parameter.

curl -X GET "https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/overview/worldwide/url?url=https%3A%2F%2Fseranking.com%2Fapi.html" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with two optional array fields: adv and organic. Each array contains objects with source (always "worldwide"), price_sum as a number, traffic_sum as an integer, and keywords_count as an integer.

{
  "adv": [
    {
      "source": "worldwide",
      "price_sum": 1250.5,
      "traffic_sum": 3400,
      "keywords_count": 87
    }
  ],
  "organic": [
    {
      "source": "worldwide",
      "price_sum": 980.0,
      "traffic_sum": 12800,
      "keywords_count": 214
    }
  ]
}

TRY ITLIVE · 500 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Retrieves a worldwide URL overview for the url you pass in the query string. The response is a JSON object containing adv and organic arrays with aggregated metrics for each result item.

Query Parameter(s)

Attribute	Type	Description
url	String	The URL to analyze.
fields	String	Optional field selector.

Response

Returns a JSON object with two array fields: adv and organic. Each array contains objects with source, price_sum, traffic_sum, and keywords_count fields.

Parameter	Type	Description
adv	Object Array	Array of worldwide advertising overview items. Each item has: - `source` (`String`): Always `"worldwide"`. - `price_sum` (`Number`): Floating-point total price sum. - `traffic_sum` (`Integer`): Total traffic sum. - `keywords_count` (`Integer`): Total keywords count.
organic	Object Array	Array of worldwide organic overview items. Each item has: - `source` (`String`): Always `"worldwide"`. - `price_sum` (`Number`): Floating-point total price sum. - `traffic_sum` (`Integer`): Total traffic sum. - `keywords_count` (`Integer`): Total keywords count.

▣ ENDPOINT 02 / 10

GET

Get Domain Competitors

https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/competitors

QUICKSTART

GUIDE

Quickstart

Fetch competitor domains for a given source and domain. The type query parameter is optional, so this minimal call uses the default organic value.

curl -X GET "https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/competitors?source=us&domain=seranking.com&type=organic" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON array of competitor objects. Each object can include domain, price_sum, traffic_sum, total_keywords, common_keywords, domain_relevance, and missing_keywords.

[
  {
    "domain": "competitor.com",
    "price_sum": 123.45,
    "traffic_sum": 6789,
    "total_keywords": 250,
    "common_keywords": 42,
    "domain_relevance": 0.67,
    "missing_keywords": 208
  }
]

TRY ITLIVE · 500 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns a list of competing domains for the given source domain, using the supplied domain and source query parameters. The response is a JSON array of competitor objects with aggregate metrics for each competitor.

Query Parameter(s)

Attribute	Type	Description
type	ENUM	Allowed values: `organic`, `adv`. Default: `organic`.
domain	String	The domain to analyze.
source	String	The source domain or source identifier used for the competitor lookup.

Response

Returns a JSON array of objects. Each object includes competitor metrics for a domain string, price_sum float, traffic_sum integer, total_keywords integer, common_keywords integer, domain_relevance float, and missing_keywords integer.

Parameter	Type	Description
domain	String	The competitor domain.
price_sum	Number	Floating-point aggregate price value for the competitor.
traffic_sum	Integer	Aggregate traffic value for the competitor.
total_keywords	Integer	Total keyword count for the competitor.
common_keywords	Integer	Number of keywords shared with the source domain.
domain_relevance	Number	Floating-point relevance score for the competitor domain.
missing_keywords	Integer	Number of keywords missing from the competitor domain.

▣ ENDPOINT 03 / 10

GET

Get Domain Keywords

https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/keywords

QUICKSTART

GUIDE

Quickstart

Fetch keyword data for a domain by providing the required source query parameter.

curl -X GET "https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/keywords?source=us&domain=apyhub.com&type=organic&limit=10&page=1&order_field=traffic&order_type=desc" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON array of objects. Each object can include keyword metrics such as keyword (string), volume (integer), traffic (integer), position (integer), cpc (number), price (number), difficulty (integer), competition (number), traffic_percent (number), url (string), intents (array of I, N, T, C, L), and other fields shown in the schema.

[
  {
    "keyword": "running shoes",
    "volume": 5400,
    "traffic": 120,
    "position": 3
  }
]

TRY ITLIVE · 500 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns a list of domain keyword ranking records for the requested query parameters. Each item in the response represents one keyword snapshot with ranking, traffic, and related metrics.

Query Parameter(s)

Attribute	Type	Description
url	String	Domain URL to analyze.
cols	String	Comma-separated columns to return.
page	Integer	Page number. Minimum: 1. Default: 1.
type	ENUM	Keyword type. Allowed values: `organic`, `adv`. Default: `organic`.
year	Integer	Historical snapshot year.
limit	Integer	Number of records to return. Minimum: 1, maximum: 1000. Default: 100.
month	Integer	Historical snapshot month. Minimum: 1, maximum: 12.
domain	String	Domain to analyze.
source	String	Data source.
order_type	ENUM	Sort direction. Allowed values: `asc`, `desc`. Default: `desc`.
pos_change	ENUM	Filter by position change. Allowed values: `up`, `down`, `new`, `lost`, `diff`, `same`.
filter[url]	String	Filter by URL.
order_field	ENUM	Sort field. Allowed values: `traffic`, `volume`, `position`, `cpc`, `competition`, `kei`, `difficulty`, `traffic_percent`, `price`. Default: `traffic`.
filter[cpc][to]	Number	Maximum CPC. Minimum: 0.
filter[intents]	String	Filter by intents.
filter[keyword]	String	Filter by keyword.
with_subdomains	Boolean	Include subdomains. Default: `true`.
filter[cpc][from]	Number	Minimum CPC. Minimum: 0.
filter[price][to]	Number	Maximum price. Minimum: 0.
filter[volume][to]	Integer	Maximum volume. Minimum: 0.
filter[price][from]	Number	Minimum price. Minimum: 0.
filter[traffic][to]	Integer	Maximum traffic. Minimum: 0.
filter[position][to]	Integer	Maximum position. Minimum: 1.
filter[volume][from]	Integer	Minimum volume. Minimum: 0.
filter[serp_features]	String	Filter by SERP features.
filter[traffic][from]	Integer	Minimum traffic. Minimum: 0.
filter[difficulty][to]	Integer	Maximum difficulty. Minimum: 0, maximum: 100.
filter[position][from]	Integer	Minimum position. Minimum: 1.
filter[competition][to]	Number	Maximum competition. Minimum: 0, maximum: 1.
filter[difficulty][from]	Integer	Minimum difficulty. Minimum: 0, maximum: 100.
filter[competition][from]	Number	Minimum competition. Minimum: 0, maximum: 1.
filter[keyword_count][to]	Integer	Maximum keyword count. Minimum: 1.
filter[keyword_count][from]	Integer	Minimum keyword count. Minimum: 1.
filter[traffic_percent][to]	Number	Maximum traffic percent.
filter[characters_count][to]	Integer	Maximum character count. Minimum: 1.
filter[serp_features_2][mode]	ENUM	SERP feature match mode. Allowed values: `with_link`, `without_link`.
filter[traffic_percent][from]	Number	Minimum traffic percent.
filter[characters_count][from]	Integer	Minimum character count. Minimum: 1.
filter[multi_keyword_excluded]	String	Exclude matching multi-keyword values.
filter[multi_keyword_included]	String	Include matching multi-keyword values.
filter[serp_features_2][value][0]	String	First SERP feature value to match.

Response

Returns a JSON array of objects, where each object contains keyword ranking data for one result item. The top-level fields in each object include cpc (number), url (string), block (string), price (number), volume (integer), intents (array of strings), keyword (string), traffic (integer), position (integer), prev_pos (integer or null), block_type (string or null), difficulty (integer), competition (number), snippet_num (integer), total_sites (integer or null), serp_features (array of strings), snippet_title (string), block_position (integer), snippets_count (integer), traffic_percent (number), snippet_description (string), and snippet_display_url (string).

Parameter	Type	Description
cpc	Number	CPC value.
url	String	Result URL.
block	String	Paid only.
price	Number	Price value.
volume	Integer	Search volume.
intents	String Array	Intent codes. Allowed values: `I`, `N`, `T`, `C`, `L`.
keyword	String	Keyword text.
traffic	Integer	Traffic value.
position	Integer	Current position.
prev_pos	Integer	Previous position. Nullable.
block_type	String	Block type. Nullable.
difficulty	Integer	Difficulty score.
competition	Number	Competition value.
snippet_num	Integer	Paid only.
total_sites	Integer	Total sites. Nullable.
serp_features	String Array	SERP features associated with the keyword.
snippet_title	String	Paid only.
block_position	Integer	Block position.
snippets_count	Integer	Paid only.
traffic_percent	Number	Traffic share percentage.
snippet_description	String	Paid only.
snippet_display_url	String	Paid only.

▣ ENDPOINT 04 / 10

GET

Get Domain Paid Ads

https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/ads

QUICKSTART

GUIDE

Quickstart

Get domain ads data by providing the required source query parameter.

curl -X GET "https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/ads?source=us&domain=booking.com&limit=10&page=1" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON array. Each item is one of two object shapes: a keyword-based result with fields like domain, snippets, ads_count, price_sum, traffic_sum, and keywords_count; or a domain-based result with cpc, volume, keyword, snippets, ads_count, and competition.

[
  {
    "domain": "example.com",
    "snippets": {},
    "ads_count": 12,
    "price_sum": 34.5,
    "traffic_sum": 1200,
    "keywords_count": 8
  }
]

TRY ITLIVE · 500 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns paid ads data for either a keyword or a domain. The request is sent as query parameters, and the response is a JSON array whose item shape depends on whether you queried by keyword or by domain.

Query Parameter(s)

Attribute	Type	Description
to	String	`YYYY-MM`
from	String	`YYYY-MM`
page	Integer	Default: `1`
limit	Integer	Default: `100`; minimum: `1`; maximum: `100`
domain	String	Query by domain.
source	String	Query source.
keyword	String	Query by keyword.

Response

Returns a JSON array. Each array item is an object, and the object shape depends on the request mode: when the request used keyword, each item contains domain, snippets, ads_count, price_sum, traffic_sum, and keywords_count; when the request used domain, each item contains cpc, volume, keyword, snippets, ads_count, and competition.

Parameter	Type	Description
domain	String	Present in the keyword-based response shape.
snippets	Object	Keyed by `YYYY-MM`. Each value is an object with `url`, `position`, `snippet_num`, `snippet_count`, `snippet_title`, `snippet_description`, and `snippet_display_url`.
ads_count	Integer	Number of ads.
price_sum	Number	Float value. Present in the keyword-based response shape.
traffic_sum	Integer	Present in the keyword-based response shape.
keywords_count	Integer	Present in the keyword-based response shape.
cpc	Number	Float value. Present in the domain-based response shape.
volume	Integer	Present in the domain-based response shape.
keyword	String	Present in the domain-based response shape.
competition	Number	Float value. Present in the domain-based response shape.

▣ ENDPOINT 05 / 10

GET

Get Regional Domain Overview

https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/overview/db

QUICKSTART

GUIDE

Quickstart

Fetch the domain overview by providing the required source query parameter.

curl -X GET "https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/overview/db?source=us&domain=seranking.com&with_subdomains=true" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with optional adv and organic object fields. Each object contains domain overview metrics such as year, month, target, base_domain, counts, traffic, and price totals.

{
  "adv": {
    "year": 2024,
    "month": 1,
    "target": "example.com",
    "top1_2": 10,
    "top3_5": 20,
    "top6_8": 5,
    "top9_11": 2,
    "price_sum": 123.45,
    "base_domain": "example.com",
    "traffic_sum": 1000,
    "keywords_count": 42,
    "keywords_up_count": 10,
    "keywords_new_count": 4,
    "keywords_down_count": 3,
    "keywords_lost_count": 1,
    "keywords_equal_count": 24
  },
  "organic": {
    "year": 2024,
    "month": 1,
    "target": "example.com",
    "top1_5": 8,
    "top6_10": 12,
    "top11_20": 15,
    "top21_50": 30,
    "price_sum": 98.76,
    "top51_100": 60,
    "base_domain": "example.com",
    "traffic_sum": 2000,
    "keywords_count": 60,
    "keywords_up_count": 12,
    "keywords_new_count": 6,
    "keywords_down_count": 4,
    "keywords_lost_count": 2,
    "keywords_equal_count": 36
  }
}

TRY ITLIVE · 500 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Gets a domain overview by region for the supplied query parameters and returns two summary objects: adv and organic.

Query Parameter(s)

Attribute	Type	Description
url	String	The URL to analyze.
domain	String	The domain to analyze.
source	String	The source identifier to use for the overview lookup.
with_subdomains	Boolean	Whether to include subdomains in the domain overview. Default: `true`.

Response

Returns a JSON object with two top-level object fields: adv and organic. Each field contains regional domain overview metrics such as year, month, target, rank-bucket counts, price_sum, base_domain, traffic_sum, and keyword counts. Success status code is not declared in the schema.

Parameter	Type	Description
adv	Object	Regional paid/advertising overview metrics object.
adv.year	Integer	Year for the overview data.
adv.month	Integer	Month for the overview data.
adv.target	String	Target identifier for the overview.
adv.top1_2	Integer	Count in the 1–2 position bucket.
adv.top3_5	Integer	Count in the 3–5 position bucket.
adv.top6_8	Integer	Count in the 6–8 position bucket.
adv.top9_11	Integer	Count in the 9–11 position bucket.
adv.price_sum	Number	Total price sum as a floating-point number.
adv.base_domain	String	Base domain associated with the overview.
adv.traffic_sum	Integer	Total traffic sum.
adv.keywords_count	Integer	Total number of keywords.
adv.keywords_up_count	Integer	Number of keywords that moved up.
adv.keywords_new_count	Integer	Number of new keywords.
adv.keywords_down_count	Integer	Number of keywords that moved down.
adv.keywords_lost_count	Integer	Number of lost keywords.
adv.keywords_equal_count	Integer	Number of unchanged keywords.
organic	Object	Regional organic overview metrics object.
organic.year	Integer	Year for the overview data.
organic.month	Integer	Month for the overview data.
organic.target	String	Target identifier for the overview.
organic.top1_5	Integer	Count in the 1–5 position bucket.
organic.top6_10	Integer	Count in the 6–10 position bucket.
organic.top11_20	Integer	Count in the 11–20 position bucket.
organic.top21_50	Integer	Count in the 21–50 position bucket.
organic.price_sum	Number	Total price sum as a floating-point number.
organic.top51_100	Integer	Count in the 51–100 position bucket.
organic.base_domain	String	Base domain associated with the overview.
organic.traffic_sum	Integer	Total traffic sum.
organic.keywords_count	Integer	Total number of keywords.
organic.keywords_up_count	Integer	Number of keywords that moved up.
organic.keywords_new_count	Integer	Number of new keywords.
organic.keywords_down_count	Integer	Number of keywords that moved down.
organic.keywords_lost_count	Integer	Number of lost keywords.
organic.keywords_equal_count	Integer	Number of unchanged keywords.

▣ ENDPOINT 06 / 10

GET

Get Worldwide Domain Overview

https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/overview/worldwide

QUICKSTART

GUIDE

Quickstart

Fetch a worldwide domain overview for a domain by passing it as a query parameter.

curl -X GET "https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/overview/worldwide?domain=seranking.com&currency=USD&with_subdomains=1" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with two top-level array fields: adv and organic. Each array contains objects with domain overview metrics such as source, country, price_sum, traffic_sum, keywords_count, positions_tops, and the position counters.

{
  "adv": [],
  "organic": []
}

TRY ITLIVE · 500 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns a worldwide domain overview for the specified domain. The response contains separate adv and organic arrays with per-country/source metrics such as traffic, keyword counts, and position distribution.

Query Parameter(s)

Attribute	Type	Description
url	String	Domain URL to analyze.
domain	String	Domain to analyze.
fields	String	Filters or selects response fields.
currency	String	Currency used for price-related values. Default: `USD`.
show_zones_list	ENUM	Whether to include the zones list. Allowed values: `0`, `1`. Default: `0`.
with_subdomains	ENUM	Whether to include subdomains. Allowed values: `0`, `1`. Default: `1`.

Response

Returns a JSON object with two array fields: adv and organic. Each array item is an object containing source and country-level metrics, including price_sum, traffic_sum, keywords_count, positions_tops, and several position change counts. Success uses the documented GET /v1/domain/overview/worldwide response shape.

Parameter	Type	Description
adv	Object Array	Array of advertising overview objects. Each item includes `source`, `country`, `price_sum`, `traffic_sum`, `keywords_count`, `positions_tops`, `positions_up_count`, `positions_new_count`, `positions_down_count`, `positions_lost_count`, and `positions_equal_count`.
adv[].source	String	Data source identifier.
adv[].country	String	Country associated with the metrics.
adv[].price_sum	Number	Sum of prices. Float value.
adv[].traffic_sum	Integer	Total traffic.
adv[].keywords_count	Integer	Total keyword count.
adv[].positions_tops	Object	Position distribution object with top-rank buckets.
adv[].positions_tops.top1_2	Integer	Count of positions in the `1-2` bucket.
adv[].positions_tops.top1_5	Integer	Count of positions in the `1-5` bucket.
adv[].positions_tops.top3_5	Integer	Count of positions in the `3-5` bucket.
adv[].positions_tops.top6_8	Integer	Count of positions in the `6-8` bucket.
adv[].positions_tops.top6_10	Integer	Count of positions in the `6-10` bucket.
adv[].positions_tops.top9_11	Integer	Count of positions in the `9-11` bucket.
adv[].positions_tops.top11_20	Integer	Count of positions in the `11-20` bucket.
adv[].positions_tops.top21_50	Integer	Count of positions in the `21-50` bucket.
adv[].positions_tops.top51_100	Integer	Count of positions in the `51-100` bucket.
adv[].positions_up_count	Integer	Count of positions that moved up.
adv[].positions_new_count	Integer	Count of new positions.
adv[].positions_down_count	Integer	Count of positions that moved down.
adv[].positions_lost_count	Integer	Count of lost positions.
adv[].positions_equal_count	Integer	Count of positions that stayed equal.
organic	Object Array	Array of organic overview objects. Each item includes `source`, `country`, `price_sum`, `traffic_sum`, `keywords_count`, `positions_tops`, and position change counts.
organic[].source	String	Data source identifier.
organic[].country	String	Country associated with the metrics.
organic[].price_sum	Number	Sum of prices. Float value.
organic[].traffic_sum	Integer	Total traffic.
organic[].keywords_count	Integer	Total keyword count.
organic[].positions_tops	Object	Position distribution object with top-rank buckets.
organic[].positions_tops.top1_2	Integer	Count of positions in the `1-2` bucket.
organic[].positions_tops.top1_5	Integer	Count of positions in the `1-5` bucket.
organic[].positions_tops.top3_5	Integer	Count of positions in the `3-5` bucket.
organic[].positions_tops.top6_8	Integer	Count of positions in the `6-8` bucket.
organic[].positions_tops.top6_10	Integer	Count of positions in the `6-10` bucket.
organic[].positions_tops.top9_11	Integer	Count of positions in the `9-11` bucket.
organic[].positions_tops.top11_20	Integer	Count of positions in the `11-20` bucket.
organic[].positions_tops.top21_50	Integer	Count of positions in the `21-50` bucket.
organic[].positions_tops.top51_100	Integer	Count of positions in the `51-100` bucket.
organic[].positions_up_count	Integer	Count of positions that moved up.
organic[].positions_new_count	Integer	Count of new positions.
organic[].positions_down_count	Integer	Count of positions that moved down.
organic[].positions_lost_count	Integer	Count of lost positions.
organic[].positions_equal_count	Integer	Count of positions that stayed equal.

▣ ENDPOINT 07 / 10

GET

Get Top Domain Pages

https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/pages

QUICKSTART

GUIDE

Quickstart

Fetch domain pages by passing the required target, scope, and source query parameters.

curl -X GET "https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/pages?target=seranking.com&scope=domain&source=us&type=organic&limit=100" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON array of objects. Each object can include url, title, intents, price_sum, traffic_sum, keywords_count, and traffic_percent.

[
  {
    "url": "https://example.com/pricing",
    "title": "Pricing",
    "price_sum": 120.5,
    "traffic_sum": 3400,
    "keywords_count": 85,
    "traffic_percent": 12.4
  }
]

TRY ITLIVE · 500 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns a list of pages for a domain lookup, with each item including the page URL, title, intent breakdown, and aggregate metrics such as price, traffic, keyword count, and traffic percent. The request is configured through query parameters that control the target, scope, ordering, pagination, and optional filters.

Query Parameter(s)

Attribute	Type	Description
type	String	Allowed values: `organic`, `adv`. Default: `organic`.
limit	Integer	Default: `1000`.
scope	String	Allowed values: `base_domain`, `domain`, `url`.
offset	Integer	Pagination offset.
source	String	Source domain or source value.
target	String	Target domain or target value.
order_type	String	Allowed values: `asc`, `desc`. Default: `desc`.
order_field	String	Allowed values: `keywords_count`, `traffic_sum`, `traffic_percent`, `price_sum`. Default: `keywords_count`.
filter[domain_url]	String	Filter by domain URL.
filter[price_sum][to]	Number	Upper bound for `price_sum`.
filter[price_sum][from]	Number	Lower bound for `price_sum`.
filter[traffic_sum][to]	Integer	Upper bound for `traffic_sum`.
filter[traffic_sum][from]	Integer	Lower bound for `traffic_sum`.
filter[keywords_count][to]	Integer	Upper bound for `keywords_count`.
filter[keywords_count][from]	Integer	Lower bound for `keywords_count`.
filter[domain_traffic_percent][to]	Number	Upper bound for `traffic_percent` filtering.
filter[domain_traffic_percent][from]	Number	Lower bound for `traffic_percent` filtering.

Response

Returns a JSON array of page objects. Each item includes url and title strings, an intents object with C, I, L, N, and T intent objects, and the aggregate metrics price_sum, traffic_sum, keywords_count, and traffic_percent.

Parameter	Type	Description
url	String	Page URL.
title	String	Page title.
intents	Object	Intent breakdown object containing `C`, `I`, `L`, `N`, and `T`.
intents.C	Object	Intent `C` object.
intents.C.count	Integer	Count for intent `C`.
intents.C.traffic	Integer	Traffic for intent `C`.
intents.C.percents	Number	Percentage for intent `C` (`float`).
intents.I	Object	Intent `I` object.
intents.I.count	Integer	Count for intent `I`.
intents.I.traffic	Integer	Traffic for intent `I`.
intents.I.percents	Number	Percentage for intent `I` (`float`).
intents.L	Object	Intent `L` object.
intents.L.count	Integer	Count for intent `L`.
intents.L.traffic	Integer	Traffic for intent `L`.
intents.L.percents	Number	Percentage for intent `L` (`float`).
intents.N	Object	Intent `N` object.
intents.N.count	Integer	Count for intent `N`.
intents.N.traffic	Integer	Traffic for intent `N`.
intents.N.percents	Number	Percentage for intent `N` (`float`).
intents.T	Object	Intent `T` object.
intents.T.count	Integer	Count for intent `T`.
intents.T.traffic	Integer	Traffic for intent `T`.
intents.T.percents	Number	Percentage for intent `T` (`float`).
price_sum	Number	Total `price_sum` value (`float`).
traffic_sum	Integer	Total traffic sum.
keywords_count	Integer	Total keywords count.
traffic_percent	Number	Total traffic percent (`float`).

▣ ENDPOINT 08 / 10

GET

Compare Domain Keywords

https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/keywords/comparison

QUICKSTART

GUIDE

Quickstart

Compare keyword data between two sources for a domain and return the matching keyword rows.

curl -X GET "https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/keywords/comparison?source=us&domain=apple.com&compare=samsung.com&type=organic&limit=10" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON array of objects. Each object can include keyword as a string, volume and difficulty as integers, cpc and competition as numbers, and position as an integer or null.

[
  {
    "cpc": 1.25,
    "volume": 9900,
    "keyword": "domain analysis",
    "position": 3,
    "difficulty": 42,
    "competition": 0.78
  }
]

TRY ITLIVE · 500 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Compares keyword overlap and gaps between two domains or URLs, returning a filtered, ordered list of keyword rows with associated SEO metrics.

Query Parameter(s)

Attribute	Type	Description
url	String	Target URL to analyze.
cols	String	Selects which columns to return.
diff	ENUM	Difference mode. Allowed values: `0`, `1`. Default: `0`.
page	Integer	Page number. Default: `1`.
type	ENUM	Result type. Allowed values: `organic`, `adv`. Default: `organic`.
limit	Integer	Maximum number of items to return. Default: `100`. Minimum: `1`. Maximum: `1000`.
domain	String	Domain to analyze.
source	String	Source domain or URL.
compare	String	Domain or URL to compare against the source.
order_type	ENUM	Sort direction. Allowed values: `asc`, `desc`. Default: `asc`.
order_field	ENUM	Sort field. Allowed values: `keyword`, `volume`, `cpc`, `competition`, `difficulty`, `position`. Default: `keyword`.
filter[cpc][to]	Number	Maximum CPC filter value.
filter[intents]	String	Filter by intent values.
filter[keyword]	String	Filter by keyword text.
filter[cpc][from]	Number	Minimum CPC filter value.
filter[volume][to]	Integer	Maximum volume filter value.
filter[volume][from]	Integer	Minimum volume filter value.
filter[serp_features]	String	Filter by SERP features.
filter[difficulty][to]	Integer	Maximum difficulty filter value. Minimum: `0`. Maximum: `100`.
filter[competition][to]	Number	Maximum competition filter value. Minimum: `0`. Maximum: `1`.
filter[difficulty][from]	Integer	Minimum difficulty filter value. Minimum: `0`. Maximum: `100`.
filter[competition][from]	Number	Minimum competition filter value. Minimum: `0`. Maximum: `1`.
filter[multi_keyword_excluded]	String	Excludes keywords matching the provided value.
filter[multi_keyword_included]	String	Includes keywords matching the provided value.

Response

Returns a JSON array of keyword objects. Each item contains cpc as a number, volume as an integer, keyword as a string, position as an integer or null, difficulty as an integer, and competition as a number.

Attribute	Type	Description
cpc	Number	Cost-per-click value as a float.
volume	Integer	Keyword volume.
keyword	String	Keyword text.
position	Integer	Keyword position; nullable in the schema.
difficulty	Integer	Keyword difficulty.
competition	Number	Competition value as a float.

▣ ENDPOINT 09 / 10

GET

Get Domain Historical Trends

https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/overview/history

QUICKSTART

GUIDE

Quickstart

Fetch the domain history for a source by passing the required source query parameter.

curl -X GET "https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/overview/history?source=us&domain=seranking.com&type=organic&with_subdomains=1" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON array of objects. Each object may include fields such as year, month, top1_2, top1_5, top3_5, top6_8, top6_10, top9_11, top11_20, top21_50, price_sum, top51_100, traffic_sum, and keywords_count.

[
  {
    "year": 2024,
    "month": 1,
    "top1_2": 12,
    "top1_5": 18,
    "top3_5": 9,
    "top6_8": 6,
    "top6_10": 4,
    "top9_11": 3,
    "top11_20": 15,
    "top21_50": 27,
    "price_sum": 124.5,
    "top51_100": 8,
    "traffic_sum": 3200,
    "keywords_count": 54
  }
]

TRY ITLIVE · 500 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns domain traffic and keyword history for the requested query parameters. The response is an array of monthly history objects, each containing traffic, keyword counts, and ranking-bucket metrics.

Query Parameter(s)

Attribute	Type	Description
url	String	Domain URL to analyze.
type	ENUM	Traffic type. - `organic` - `adv` Default: `organic`
domain	String	Domain name to analyze.
source	String	Source identifier used by the service.
with_subdomains	ENUM	Whether to include subdomains. - `0` - `1` Default: `1`

Response

Returns a JSON array of objects, where each object represents one month of domain history. Each item includes year and month integers, ranking-bucket integer fields, price_sum as a floating-point number, traffic_sum as an integer, and keywords_count as an integer.

Parameter	Type	Description
year	Integer	Year of the history record.
month	Integer	Month of the history record.
top1_2	Integer	Count for the `top1_2` bucket.
top1_5	Integer	Count for the `top1_5` bucket.
top3_5	Integer	Count for the `top3_5` bucket.
top6_8	Integer	Count for the `top6_8` bucket.
top6_10	Integer	Count for the `top6_10` bucket.
top9_11	Integer	Count for the `top9_11` bucket.
top11_20	Integer	Count for the `top11_20` bucket.
top21_50	Integer	Count for the `top21_50` bucket.
price_sum	Number	Floating-point sum value for the record.
top51_100	Integer	Count for the `top51_100` bucket.
traffic_sum	Integer	Total traffic for the month.
keywords_count	Integer	Total keyword count for the month.

▣ ENDPOINT 10 / 10

GET

Get Domain Subdomains

https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/subdomains

QUICKSTART

GUIDE

Quickstart

Fetch subdomains for the required target and scope, using the source you want to query.

curl -X GET "https://api.eu.apyhub.com/se-ranking/domain-analysis/v1/domain/subdomains?target=seranking.com&scope=domain&source=us&type=organic&limit=1000" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON array of objects. Each object can include url (string), price_sum (number), traffic_sum (integer), keywords_count (integer), and traffic_percent (number).

[
  {
    "url": "blog.example.com",
    "price_sum": 120.5,
    "traffic_sum": 3400,
    "keywords_count": 87,
    "traffic_percent": 12.4
  }
]

TRY ITLIVE · 500 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns a list of subdomains for the domain identified by the query parameters. The response is a JSON array of subdomain objects, each containing the fields defined in the output schema.

Query Parameter(s)

Attribute	Type	Description
type	ENUM	Allowed values: `organic`, `adv`. Default: `organic`.
limit	Integer	Maximum number of results to return. Default: `1000`.
scope	ENUM	Allowed values: `base_domain`, `domain`.
offset	Integer	Result offset for pagination.
source	String	Source identifier used to filter the subdomain data.
target	String	Target domain to analyze.
order_type	ENUM	Allowed values: `asc`, `desc`. Default: `desc`.
order_field	ENUM	Allowed values: `keywords_count`, `traffic_sum`, `traffic_percent`, `price_sum`. Default: `keywords_count`.
filter[domain_url]	String	Filters results by domain URL.
filter[price_sum][to]	Number	Upper bound for `price_sum`.
filter[price_sum][from]	Number	Lower bound for `price_sum`.
filter[traffic_sum][to]	Integer	Upper bound for `traffic_sum`.
filter[traffic_sum][from]	Integer	Lower bound for `traffic_sum`.
filter[keywords_count][to]	Integer	Upper bound for `keywords_count`.
filter[keywords_count][from]	Integer	Lower bound for `keywords_count`.
filter[domain_traffic_percent][to]	Number	Upper bound for `traffic_percent`.
filter[domain_traffic_percent][from]	Number	Lower bound for `traffic_percent`.

Response

Returns a JSON array of objects. Each object has url as a string, price_sum as a float number, traffic_sum as an integer, keywords_count as an integer, and traffic_percent as a float number.

Attribute	Type	Description
url	String	Subdomain URL.
price_sum	Number	Price sum as a floating-point value.
traffic_sum	Integer	Traffic sum.
keywords_count	Integer	Number of keywords.
traffic_percent	Number	Traffic percentage as a floating-point value.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLAnalyze AI Search Performance APISE Ranking SEO & AI Search API CALLExtract Domain Insights APIDosvak LLC CALLIntelligent Competitor Mapping APISumalya APIs CALLAnalyze Backlinks APISE Ranking SEO & AI Search API

From the blog

Reads that touch this API.

Domain Intelligence APIs: What You Can Learn About a Domain Before You Trust ItAug 26, 2026 SEO APIs: Enhancing Website Visibility and MetricsJul 9, 2026 SE Ranking Publishes Its SEO and AI Search APIs on ApyHubSep 24, 2026 Web Data Extraction: Use Cases and ApproachesJul 9, 2026