API

API / Data API / Domain Analysis

Domain Analysis

Domain Analysis API provides detailed insights into a domain’s search performance. Data is refreshed on a monthly basis.

Using the API, you can:

query regional or worldwide data
retrieve keyword statistics, domain pages, and subdomains
analyze competitors to identify common keywords and keyword gaps
retrieve paid advertising data, including ad creatives, observed positions, and traffic
access historical data to track changes in rankings, traffic, and ad performance
filter and sort results by metrics such as search volume, CPC, competition, keyword difficulty, and ranking positions

Get domain overview by region

GET https://api.seranking.com/v1/domain/overview/db
Cost: 100 credits per request

Returns detailed keyword statistics for a specified domain within a single, selected regional database. It breaks down performance for both organic and paid traffic, offering insights into keyword rankings, traffic estimates, and position changes.

Request parameters

Parameter	Type	Required	Default	Description
source	String	Yes	N/A	Country code of the regional keyword database (e.g., `us`). For acceptable values, see Regional database codes.
domain	String	Yes	N/A	Domain for which to retrieve the keyword statistics (e.g., `seranking.com`).
with_subdomains	Integer	No	`1`	Flag indicating whether subdomain data should be included in the analysis: `1` – include subdomains `0` – exclude subdomains
url	String	No	N/A	Specific URL to analyze instead of the root domain (e.g., `https://domain.com/path/page`). If provided, the `domain` parameter is ignored.

Request example

Copy

curl -X GET 'https://api.seranking.com/v1/domain/overview/db?source=xx&domain=yourdomain.com&with_subdomains=1' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

If the request is successful, the server returns a JSON object with two primary keys: organic and adv. Each of these keys details various keyword statistics for the selected database.

organic object

Parameter	Type	Description
organic.base_domain / organic.target	String	Base domain or URL used for the analysis.
organic.keywords_count	Integer	Number of organic keywords for which the domain ranks in the selected database.
organic.traffic_sum	Integer	Estimated monthly organic search traffic from ranking keywords.
organic.price_sum	Float	Estimated traffic value (PPC equivalent) for organic search data.
organic.keywords_new_count	Integer	Number of keywords for which the domain has newly started ranking.
organic.keywords_up_count	Integer	Number of keywords for which the domain’s ranking has improved.
organic.keywords_down_count	Integer	Number of keywords for which the domain’s ranking has declined.
organic.keywords_equal_count	Integer	Number of keywords for which the domain’s ranking has not changed.
organic.keywords_lost_count	Integer	Number of keywords for which the domain has dropped out of the SERPs.
organic.top1_5	Integer	Number of organic keywords ranked in positions 1–5.
organic.top6_10	Integer	Number of organic keywords ranked in positions 6–10.
organic.top11_20	Integer	Number of organic keywords ranked in positions 11–20.
organic.top21_50	Integer	Number of organic keywords ranked in positions 21–50.
organic.top51_100	Integer	Number of organic keywords ranked in positions 51–100.
organic.year	Integer	Year of the data snapshot.
organic.month	Integer	Month of the data snapshot.

adv object

Parameter	Type	Description
adv.base_domain / adv.target	String	Base domain or URL used for the analysis.
adv.keywords_count	Integer	Number of keywords for which the domain has paid ads in the selected database.
adv.traffic_sum	Integer	Estimated monthly traffic from paid keywords.
adv.price_sum	Float	Estimated traffic value (PPC equivalent) from paid keywords.
adv.keywords_new_count	Integer	Number of new keywords targeted by paid ads.
adv.keywords_up_count	Integer	Number of paid keywords where ad positions improved.
adv.keywords_down_count	Integer	Number of paid keywords where ad positions declined.
adv.keywords_equal_count	Integer	Number of paid keywords where ad positions remained unchanged.
adv.keywords_lost_count	Integer	Number of keywords for which paid ads are no longer running or appearing in the SERPs.
adv.top1_2	Integer	Number of paid keywords with ads appearing in positions 1–2.
adv.top3_5	Integer	Number of paid keywords with ads appearing in positions 3–5.
adv.top6_8	Integer	Number of paid keywords with ads appearing in positions 6–8.
adv.top9_11	Integer	Number of paid keywords with ads appearing in positions 9–11.
adv.year	Integer	Year of the data snapshot.
adv.month	Integer	Month of the data snapshot.

Response example

Copy

{

  "organic": {

    "base_domain": "example.com",

    "price_sum": 100000,

    "traffic_sum": 40000,

    "keywords_new_count": 250,

    "keywords_down_count": 70,

    "keywords_up_count": 65,

    "keywords_equal_count": 140000,

    "keywords_lost_count": 110,

    "keywords_count": 115000,

    "top1_5": 20000,

    "top6_10": 11000,

    "top11_20": 18000,

    "top21_50": 41000,

    "top51_100": 50000,

    "year": 2025,

    "month": 11

  },

  "adv": {

    "base_domain": "example.com",

    "price_sum": 85,

    "traffic_sum": 40,

    "keywords_new_count": 0,

    "keywords_down_count": 0,

    "keywords_up_count": 0,

    "keywords_equal_count": 16,

    "keywords_lost_count": 0,

    "keywords_count": 16,

    "top1_2": 15,

    "top3_5": 1,

    "top6_8": 0,

    "top9_11": 0,

    "year": 2025,

    "month": 11

  }

}

Get worldwide domain overview

GET https://api.seranking.com/v1/domain/overview/worldwide
Cost: 100 credits per request

Aggregates and returns domain search performance statistics globally for the current month. The method provides a comprehensive view of worldwide organic and paid traffic metrics, with options to customize the returned data, including currency and specific fields.

Request parameters

Parameter	Type	Required	Default	Description
domain	String	Yes	N/A	Domain name for which to retrieve worldwide statistics (e.g., `seranking.com`).
currency	String	No	`USD`	ISO 4217 currency code to be used for any monetary values (like traffic cost) returned in the response (e.g., `USD`, `EUR`, `GBP`).
fields	String	No	`price`, `traffic`, `keywords`	Comma-separated list specifying which data fields or categories to include in the response: • `price` – shows traffic price/cost value • `traffic` – shows traffic volume value • `keywords` – shows keyword count statistics • `positions_diff` – shows statistics on position changes • `positions_tops` – shows statistics on top-ranking positions
show_zones_list	String	No	`0`	Identifies whether the response should include a detailed breakdown of statistics by regional zone (country) in addition to aggregated worldwide statistics: `1` – include stats for each zone `0` – return worldwide stats only
with_subdomains	Integer	No	`1`	Flag indicating whether subdomain data should be included in the analysis: `1` – include subdomains `0` – exclude subdomains
url	String	No	N/A	Specific URL to analyze instead of the root domain (e.g., `https://domain.com/path/page`). If provided, the `domain` parameter is ignored.

Request example

Copy

curl -X GET 'https://api.seranking.com/v1/domain/overview/worldwide?domain=seranking.com&currency=USD&fields=price,traffic,keywords,positions_diff,positions_tops&show_zones_list=0' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

If the request is successful, the server returns a JSON object with two primary keys: organic and adv. Each of these keys holds an array of objects.

The first object in each array always represents the aggregated “worldwide” statistics.
If show_zones_list is set to “1” (or true), subsequent objects in the arrays will represent statistics for individual regional zones (countries).

Each object within the organic and adv arrays can contain the following parameters (depending on the fields requested):

Parameter	Type	Description
source	String	Identifier of the data scope: `worldwide` for the global summary, or a specific country code for zone-specific data when `show_zones_list` is enabled.
country	String	Descriptive name for the source: `worldwide` for the global summary, or country name for zone-specific data (e.g., `United States`).
keywords_count	Integer	Number of keywords for this scope (organic or paid, depending on the parent object).
traffic_sum	Integer	Sum of estimated traffic for this scope (organic or paid).
price_sum	Float	Estimated traffic value (PPC equivalent) in the specified currency.
positions_new_count	Integer	Number of keywords newly appearing in rankings for this scope (if `positions_diff` requested in fields).
positions_up_count	Integer	Number of keywords with improved rankings for this scope (if `positions_diff` requested in fields).
positions_down_count	Integer	Number of keywords with declined rankings for this scope (if `positions_diff` requested in fields).
positions_lost_count	Integer	Number of keywords that dropped out of rankings for this scope (if `positions_diff` requested in fields).
positions_equal_count	Integer	Number of keywords with unchanged rankings for this scope (if `positions_diff` requested in fields).
positions_tops.top1_5	Integer	Organic: keywords in positions 1–5.
positions_tops.top6_10	Integer	Organic: keywords in positions 6–10.
positions_tops.top11_20	Integer	Organic: keywords in positions 11–20.
positions_tops.top21_50	Integer	Organic: keywords in positions 21–50.
positions_tops.top51_100	Integer	Organic: keywords in positions 51–100.
positions_tops.top1_2	Integer	Paid (adv): keywords with ads in positions 1–2.
positions_tops.top3_5	Integer	Paid (adv): keywords with ads in positions 3–5.
positions_tops.top6_8	Integer	Paid (adv): keywords with ads in positions 6–8.
positions_tops.top9_11	Integer	Paid (adv): keywords with ads in positions 9–11.

Response example

Copy

{

  "organic": [

    {

      "source": "worldwide",

      "country": "Worldwide",

      "keywords_count": 823967,

      "traffic_sum": 273150,

      "price_sum": 241482.11,

      "positions_new_count": 56042,

      "positions_up_count": 56326,

      "positions_down_count": 49834,

      "positions_lost_count": 47169,

      "positions_equal_count": 876005,

      "positions_tops": {

        "top1_5": 91520,

        "top6_10": 95652,

        "top11_20": 165641,

        "top21_50": 332015,

        "top51_100": 353061

      }

    }

  ],

  "adv": [

    {

      "source": "worldwide",

      "country": "Worldwide",

      "keywords_count": 4947,

      "traffic_sum": 4369,

      "price_sum": 6509.45,

      "positions_new_count": 333,

      "positions_up_count": 7,

      "positions_down_count": 4,

      "positions_lost_count": 1742,

      "positions_equal_count": 5645,

      "positions_tops": {

        "top1_2": 4905,

        "top3_5": 1046,

        "top6_8": 38,

        "top9_11": 0

      }

    }

  ]

}

Get worldwide URL overview

GET https://api.seranking.com/v1/domain/overview/worldwide/url
Cost: 100 credits per request

Aggregates and returns URL search performance statistics globally for the current month. The method provides a comprehensive view of worldwide organic and paid traffic metrics for a specific URL, with options to customize the returned data using selected fields.

Request parameters

Parameter	Type	Required	Default	Description
url	String	Yes	N/A	Full URL to analyze (including protocol).
fields	String	No	N/A	Comma-separated list of metrics to include in the response. Accepted values: `keywords`, `traffic`, `price`.

Request example

Copy

curl -X GET 'https://api.seranking.com/v1/domain/overview/worldwide/url?fields=price,traffic,keywords&url=https://example.com/api.html' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

If the request is successful, the server returns a JSON object containing two arrays: organic and adv.

Parameter	Type	Description
source	String	Data source scope. Always `worldwide`.
keywords_count	Integer	Number of ranking keywords worldwide.
traffic_sum	Integer	Estimated total monthly traffic worldwide.
price_sum	Float	Estimated traffic value (PPC equivalent).

Response example

Copy

{

  "organic": [

    {

      "source": "worldwide",

      "keywords_count": 1791,

      "traffic_sum": 1018,

      "price_sum": 1826

    }

  ],

  "adv": [

    {

      "source": "worldwide",

      "keywords_count": 5,

      "traffic_sum": 0,

      "price_sum": 0

    }

  ]

}

Get domain traffic and keyword history

GET https://api.seranking.com/v1/domain/overview/historyCost: 100 credits per request

Retrieves historical data for a specified domain from a specific regional database. It tracks changes over time for key metrics, including the number of keywords, estimated traffic (clicks), and traffic cost estimates, for either organic or paid search.

Request parameters

Parameter	Type	Required	Default	Description
source	String	Yes	N/A	Country code of the regional keyword database (e.g., `us`). For acceptable values, see Regional database codes.
domain	String	Yes	N/A	Domain name for which to retrieve historical performance data (e.g., `seranking.com`).
type	String	No	`organic`	Search traffic type for which data is retrieved: • `organic` – organic search traffic • `adv` – paid search traffic
with_subdomains	Integer	No	`1`	Flag indicating whether subdomain data should be included in the analysis: `1` – include subdomains `0` – exclude subdomains
url	String	No	N/A	Specific URL to analyze instead of the root domain (e.g., `https://domain.com/path/page`). If provided, the `domain` parameter is ignored.

Request examples

To retrieve organic historical data:

Copy

curl -X GET 'https://api.seranking.com/v1/domain/overview/history?source=us&domain=seranking.com&type=organic' \

  -H 'Authorization: Token YOUR_API_KEY'

To retrieve paid (advertising) historical data:

Copy

curl -X GET 'https://api.seranking.com/v1/domain/overview/history?source=us&domain=seranking.com&type=adv' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

If the request is successful, the server returns a JSON array. Each object in this array represents a historical data point (typically for a specific month and year) and contains the following parameters.

Note:

The topX_Y fields for ranking distribution correspond to the type of traffic requested—organic ranking ranges or paid ad position ranges.
The topX_Y fields count position occurrences, not unique keywords. If a domain has multiple links for a single keyword, each link is counted separately in the relevant position range(s). As a result, the sum of top1_5 + top6_10 + … + top51_100 may exceed keywords_count.

Parameter	Type	Description
keywords_count	Integer	Number of unique keywords (organic or paid, depending on the request type) for which the domain had at least one result during the period.
traffic_sum	Integer	Estimation of the total search traffic (clicks) the domain received from these keywords during that period.
price_sum	Float	Estimated traffic value (PPC equivalent) in the default currency of the database.
year	Integer	Year of the historical data point.
month	Integer	Month of the historical data point (1–12).
top1_5	Integer	If type is `organic`: total number of occurrences of organic keywords ranked in positions 1–5 during that period.
top6_10	Integer	If type is `organic`: total number of occurrences of organic keywords ranked in positions 6–10 during that period.
top11_20	Integer	If type is `organic`: total number of occurrences of organic keywords ranked in positions 11–20 during that period.
top21_50	Integer	If type is `organic`: total number of occurrences of organic keywords ranked in positions 21–50 during that period.
top51_100	Integer	If type is `organic`: total number of occurrences of organic keywords ranked in positions 51–100 during that period.
top1_2	Integer	If type is `adv`: total number of occurrences of paid keywords with ads appearing in positions 1–2 during that period.
top3_5	Integer	If type is `adv`: total number of occurrences of paid keywords with ads appearing in positions 3–5 during that period.
top6_8	Integer	If type is `adv`: total number of occurrences of paid keywords with ads appearing in positions 6–8 during that period.
top9_11	Integer	If type is `adv`: total number of occurrences of paid keywords with ads appearing in positions 9–11 during that period.

Response examples

Note: topX_Y fields reflect total result occurrences, not unique keywords. This is why their sum can exceed keywords_count.

Type=organic

Copy

[

  {

    "keywords_count": 104199,

    "traffic_sum": 35838,

    "top1_5": 12629,

    "top6_10": 11401,

    "top11_20": 19134,

    "top21_50": 39725,

    "top51_100": 46089,

    "year": 2025,

    "month": 4,

    "price_sum": 85424.78

  },

  {

    "keywords_count": 103538,

    "traffic_sum": 34402,

    "top1_5": 9107,

    "top6_10": 11517,

    "top11_20": 19029,

    "top21_50": 39617,

    "top51_100": 45963,

    "year": 2025,

    "month": 5,

    "price_sum": 85721.73

  }

]

Type=adv

Copy

[

  {

    "keywords_count": 7,

    "traffic_sum": 0,

    "top1_2": 7,

    "top3_5": 0,

    "top6_8": 0,

    "top9_11": 0,

    "year": 2025,

    "month": 4,

    "price_sum": 0

  },

  {

    "keywords_count": 8,

    "traffic_sum": 0,

    "top1_2": 8,

    "top3_5": 0,

    "top6_8": 0,

    "top9_11": 0,

    "year": 2025,

    "month": 5,

    "price_sum": 0

  }

]

Get domain keyword rankings

GET https://api.seranking.com/v1/domain/keywords
Cost: 100 credits per request

Returns the keywords a domain (or a specific URL) ranks for in a regional database, organic or paid. Supports historical month-by-month snapshots, advanced filtering across keyword properties, SERP-feature presence, search intent, and traffic share.

Request parameters

Required fields

Either domain or url must be supplied. If both are sent, url takes precedence and domain is silently dropped.

Parameter	Type	Description
`source`	String	Country code of the regional keyword database (e.g., `us`, `uk`, `de`). See Regional database codes.
`domain`	String	Domain to retrieve rankings for (e.g., `booking.com`). Mutually exclusive with `url`.
`url`	String	Exact URL to retrieve rankings for (e.g., `https://seranking.com/api.html`). When supplied, the `with_subdomains` flag has no effect — only this exact URL is considered.

Search type, pagination, ordering

Parameter	Type	Default	Description
`type`	`organic` \| `adv`	`organic`	Search-traffic type. `adv` returns paid-search keywords with snippet fields populated.
`with_subdomains`	Boolean	`true`	When `true`, include keywords ranking for any subdomain of `domain`. When `false`, restrict to the exact `domain`. Ignored when `url` is used. Also accepts `1`/`0`.
`page`	Integer ≥ 1	`1`	Page number for paginated results.
`limit`	Integer 1–1000	`100`	Page size. Values > 1000 are silently capped at 1000.
`order_field`	enum	`traffic`	Sort key. Valid values: `traffic`, `volume`, `position`, `cpc`, `competition`, `kei`, `difficulty`, `traffic_percent`, `price`.
`order_type`	`asc` \| `desc`	`desc`	Sort direction.
`cols`	String	(default set)	Comma-separated list of fields to return. See Default response columns. Invalid column names are silently dropped.

Historical snapshots (year / month)

Parameter	Type	Default	Description
`year`	Integer	current	Year of the historical snapshot to retrieve. Must be supplied together with `month`.
`month`	Integer 1–12	current	Month of the historical snapshot. Must be supplied together with `year`. Out-of-range values return HTTP 400 `invalid month`.

Semantics:

Both omitted → current snapshot.
Both supplied with a month within the retention window → historical snapshot.
Only one of the two supplied → current snapshot (the lone parameter is silently ignored — there is no error).
Future date → current snapshot (silent fallback).
Date older than the retention window → empty array [].

⚠ Historical responses use a different schema than current responses. See Response shape — historical below. Clients that consume both must branch on whether year/month were sent.

Filters

All filter keys use bracket-path syntax (filter[name]=value or filter[name][from]=value). Filters within a single key combine with AND; multiple values within one filter combine with OR.

Position-change filter

Parameter	Type	Description
`pos_change`	enum	Selects keywords by how their position changed vs. the previous snapshot. Values: `up` (improved), `down` (worsened), `new` (`prev_pos: null`), `lost` (dropped from SERP), `diff` (any change — equivalent to `up ∪ down`), `same` (unchanged). Unknown values are silently ignored (filter does not apply).

Range filters (`from` / `to`)

All accept any combination of from and to; either bound can be omitted.

Parameter	Type	Notes
`filter[volume][from]` / `[to]`	Integer ≥ 0	Monthly search volume.
`filter[traffic][from]` / `[to]`	Integer ≥ 0	Estimated monthly traffic to the ranking URL.
`filter[traffic_percent][from]` / `[to]`	Float	Share (%) of the keyword’s total traffic captured by the domain.
`filter[position][from]` / `[to]`	Integer ≥ 1	Ranking position.
`filter[keyword_count][from]` / `[to]`	Integer ≥ 1	Number of words in the keyword phrase.
`filter[characters_count][from]` / `[to]`	Integer ≥ 1	Character length of the keyword phrase.
`filter[cpc][from]` / `[to]`	Float ≥ 0	Cost per click. USD.
`filter[price][from]` / `[to]`	Float ≥ 0	Estimated traffic value (PPC-equivalent). USD.
`filter[competition][from]` / `[to]`	Float	Competition score (0.00–1.00).
`filter[difficulty][from]` / `[to]`	Integer 0–100	Keyword difficulty.

Text filters

JSON-encoded value; see Text search JSON structure.

Parameter	Description
`filter[keyword]`	Keyword text to match.
`filter[multi_keyword_included]`	Must-include keyword tokens.
`filter[multi_keyword_excluded]`	Must-exclude keyword tokens.
`filter[url]`	Filter by ranking URL (substring/pattern). Single base array element only — no OR logic. Use the top-level `url` request param for an exact single-URL match.

Intent filter

Parameter	Description
`filter[intents]`	Comma-separated short codes — `I` (informational), `N` (navigational), `T` (transactional), `C` (commercial), `L` (local). Multi-value semantics: keyword passes if any listed intent matches. Unknown codes are silently ignored.

SERP-feature filters — pick the right one

These two filters answer different questions:

Filter	Question it answers
`filter[serp_features]`	Does the SERP for this keyword have feature X at all? (Domain may or may not appear inside it.)
`filter[serp_features_2]`	Is the analyzed domain actually mentioned inside feature X on the SERP?

Response parameters

Current

If the request succeeds, the server returns an HTTP 200 with a JSON array of keyword objects. The default response includes 16 fields; request cols= to project a subset.

Default response columns

When cols is omitted (or empty), all 16 of the following are returned:

Copy

block_position, block_type, competition, cpc, difficulty, intents, keyword,

position, prev_pos, price, serp_features, total_sites, traffic, traffic_percent,

url, volume

For type=adv (paid search), the block and snippet_* family are also returned when explicitly requested.

Field reference

Field	Type	Description
`keyword`	String	The keyword phrase.
`position`	Integer	Current ranking position (organic) or ad position (paid).
`prev_pos`	Integer \| null	Previous-period position. `null` for new keywords.
`volume`	Integer	Average monthly search volume.
`cpc`	Float	Average cost per click, USD.
`competition`	Float	Competition score, 0.00 (low) – 1.00 (high).
`difficulty`	Integer	Keyword difficulty, 0–100.
`url`	String	URL of the ranking page (or the URL used in the ad for paid).
`total_sites`	Integer \| null	Estimated number of sites ranking for this keyword. Often `null`.
`traffic`	Integer	Estimated monthly traffic this keyword drives to the URL.
`traffic_percent`	Float	Share of the keyword’s total traffic the domain captures (%).
`price`	Float	Estimated traffic value (PPC equivalent), USD.
`intents`	Array\<String>	Detected intents — short codes `I` / `N` / `T` / `C` / `L`.
`serp_features`	Array\<String>	SERP features present on this keyword’s SERP. See SERP features.
`block_type`	String \| null	Type of SERP block where the result appears (e.g., `featured_snippets`, `tads`, `local_pack`, `sitelinks`). `null` indicates an organic 10-blue-links result.
`block_position`	Integer	Position of the block on the SERP.
`block`	String	(Paid only.) Ad placement on the SERP, e.g., `top`, `bottom`.
`snippet_num`	Integer	(Paid only.) Identifier of the ad snippet.
`snippets_count`	Integer	(Paid only.) Number of ad snippets the domain runs on this keyword.
`snippet_title`	String	(Paid only.) Ad title.
`snippet_description`	String	(Paid only.) Ad body copy.
`snippet_display_url`	String	(Paid only.) Display URL of the ad.

📝 kei (Keyword Effectiveness Index) is accepted as an order_field value but is not a selectable response column. Requesting cols=kei silently drops it.

Example – organic, current

Copy

[

  {

    "block_type": null,

    "block_position": 4,

    "keyword": "ranking",

    "position": 4,

    "prev_pos": 4,

    "volume": 22400,

    "cpc": 0,

    "competition": 0,

    "url": "https://seranking.com/",

    "difficulty": 59,

    "total_sites": null,

    "traffic": 836,

    "traffic_percent": 2.09,

    "price": 0,

    "serp_features": ["sitelinks", "video", "sge", "related_searches"],

    "intents": ["I", "N"]

  }

]

Historical (`year` + `month`)

When a request includes valid year and month, the upstream returns data from a different store with a different schema. Five fields are renamed or retyped, and two are dropped:

Field	Current snapshot	Historical snapshot
`prev_pos`	Integer \| null	Absent (renamed below).
`previous_position`	Absent.	Integer — replaces `prev_pos`.
`volume`	Integer (e.g. `2240000`)	String (e.g. `"2900"`).
`traffic`	Integer (e.g. `2307`)	String (e.g. `"1246"`).
`intents`	Short codes (`["I", "N"]`)	Long names (`["INFORMATIONAL", "NAVIGATIONAL"]`).
`total_sites`	Present (often `null`).	Absent.
`block_type`	Present.	Absent.
Other fields	(numeric types as documented above)	(same as current).

Clients consuming both shapes should branch on whether year/month were sent.

Example – historical

Copy

[

  {

    "competition": 0.13,

    "intents": ["INFORMATIONAL", "NAVIGATIONAL"],

    "serp_features": ["reviews", "sitelinks", "video", "people_also_ask"],

    "keyword": "se rank",

    "block_position": 0,

    "volume": "2900",

    "position": 1,

    "price": 797.75,

    "traffic": "1246",

    "difficulty": 62,

    "previous_position": 1,

    "traffic_percent": 3.58,

    "cpc": 0.64,

    "url": "https://seranking.com/"

  }

]

Examples

1. Domain, paid search, sort by CPC

Copy

curl 'https://api.seranking.com/v1/domain/keywords?source=us&domain=booking.com&type=adv&limit=2&cols=keyword,cpc,volume,block_type,block_position,snippet_title&order_field=cpc&order_type=desc' \

  -H 'Authorization: Token YOUR_API_KEY'

2. Specific URL, organic, with SERP feature present

Copy

curl 'https://api.seranking.com/v1/domain/keywords?source=us&url=https://seranking.com/api.html&type=organic&limit=2&filter[serp_features]=sitelinks' \

  -H 'Authorization: Token YOUR_API_KEY'

3. AI Overview cites the analyzed domain

Copy

curl 'https://api.seranking.com/v1/domain/keywords?source=us&domain=booking.com&filter[serp_features_2][mode]=with_link&filter[serp_features_2][value][0]=sge' \

  -H 'Authorization: Token YOUR_API_KEY'

4. AI Overview present but does NOT cite the domain (citation-gap opportunity)

Copy

curl 'https://api.seranking.com/v1/domain/keywords?source=us&domain=booking.com&filter[serp_features_2][mode]=without_link&filter[serp_features_2][value][0]=sge' \

  -H 'Authorization: Token YOUR_API_KEY'

5. Either AI Overview OR Reviews cites the domain (multi-value)

Copy

curl 'https://api.seranking.com/v1/domain/keywords?source=us&domain=booking.com&filter[serp_features_2][mode]=with_link&filter[serp_features_2][value][0]=sge&filter[serp_features_2][value][1]=reviews' \

  -H 'Authorization: Token YOUR_API_KEY'

6. Historical snapshot — same domain, 6 months ago

Copy

curl 'https://api.seranking.com/v1/domain/keywords?source=us&domain=seranking.com&year=2024&month=6&limit=5' \

  -H 'Authorization: Token YOUR_API_KEY'

Compare with the current snapshot to see month-over-month movement. Remember the historical response shape is different.

7. Position-change feed — winners and losers in one call

Copy

# Keywords that gained positions vs. the previous period

curl 'https://api.seranking.com/v1/domain/keywords?source=us&domain=seranking.com&pos_change=up&order_field=position&order_type=asc&limit=20' \

  -H 'Authorization: Token YOUR_API_KEY'

Copy

# New SERP entries in the period (prev_pos is null)

curl 'https://api.seranking.com/v1/domain/keywords?source=us&domain=seranking.com&pos_change=new&limit=20' \

  -H 'Authorization: Token YOUR_API_KEY'

8. Long-tail informational keywords with low difficulty

Copy

curl 'https://api.seranking.com/v1/domain/keywords?source=us&domain=seranking.com\

&filter[intents]=I\

&filter[difficulty][to]=30\

&filter[volume][from]=100\

&filter[keyword_count][from]=4\

&order_field=traffic_percent&order_type=desc&limit=50' \

  -H 'Authorization: Token YOUR_API_KEY'

Get domain pages

GET https://api.seranking.com/v1/domain/pages
Cost: 100 credits per request

Retrieves a list of individual pages ranking within a specified domain, along with their organic or paid search performance metrics. This endpoint helps identify which specific URLs contribute the most to visibility, traffic, and value in a regional database.

Request parameters

Parameter	Type	Required	Default	Description
target	String	Yes	N/A	Root domain to analyze (e.g., `example.com`).
scope	String	Yes	N/A	Scope of analysis: • `base_domain` – includes all subdomains under the registrable domain. • `domain` – analyzes pages under the specified host only. • `url` – analyzes a single, specific URL including its path and query parameters.
source	String	Yes	N/A	Country code of the regional keyword database (e.g., `us`). For acceptable values, see Regional database codes.
type	String	No	`organic`	Search traffic type for which data is retrieved: • `organic` – organic search traffic • `adv` – paid search traffic
order_field	String	No	`keywords_count`	Field by which results are sorted: • `keywords_count` • `traffic_sum` • `traffic_percent` • `price_sum`
order_type	String	No	`desc`	Sorting order: • `asc` – ascending • `desc` – descending
offset	Integer	No	N/A	Starting position for the paginated list.
limit	Integer	No	`1000`	Maximum number of pages to return in a single response.
filter[domain_url]	String	No	N/A	JSON string specifying the URL text that must be included. See Text search JSON structure for formatting details.
filter[domain_traffic_percent][from]	Float	No	N/A	Minimum percentage of the total domain traffic contributed by the page to be included in the results.
filter[domain_traffic_percent][to]	Float	No	N/A	Maximum percentage of the total domain traffic contributed by the page to be included in the results.
filter[keywords_count][from]	Integer	No	N/A	Minimum number of ranking keywords for the page to be included in the results.
filter[keywords_count][to]	Integer	No	N/A	Maximum number of ranking keywords for the page to be included in the results.
filter[traffic_sum][from]	Integer	No	N/A	Minimum estimated monthly traffic for the page to be included in the results.
filter[traffic_sum][to]	Integer	No	N/A	Maximum estimated monthly traffic for the page to be included in the results.
filter[price_sum][from]	Float	No	N/A	Minimum estimated traffic value (PPC equivalent) for the page to be included in the results.
filter[price_sum][to]	Float	No	N/A	Maximum estimated traffic value (PPC equivalent) for the page to be included in the results.

Request example

Copy

curl -X GET 'https://api.example.com/v1/domain/pages?target=seranking.com&scope=base_domain&source=us&type=organic' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

If the request is successful, the server returns a JSON array. Each object represents a single ranking page with aggregated metrics.

Parameter	Type	Description
url	String	Full page URL.
title	String	Page title as shown in search results.
keywords_count	Integer	Number of keywords the page ranks for.
traffic_sum	Integer	Estimated monthly traffic from ranking keywords.
traffic_percent	Float	Percentage of total domain traffic attributed to the page.
price_sum	Float	Estimated traffic value (PPC equivalent).
intents	Object	Distribution of keyword intent types for the page: • `I` – informational • `N` – navigational • `L` – local • `C` – commercial • `T` – transactional

`intents` object

Each intent key contains aggregated keyword data:

Field	Type	Description
count	Integer	Number of keywords matching the intent.
traffic	Integer	Estimated traffic from keywords with this intent.
percents	Float	Share of this intent within the page’s total keyword set.

Response example

Copy

[

  {

    "traffic_sum": 451267,

    "traffic_percent": 5.95,

    "price_sum": 403266.21,

    "keywords_count": 133271,

    "url": "https://www.booking.com/",

    "title": "Booking.com | Official site | The best hotels, flights, car rentals ...",

    "intents": {

      "I": { "count": 85939, "traffic": 440725, "percents": 43.46 },

      "N": { "count": 27623, "traffic": 374646, "percents": 13.97 },

      "L": { "count": 46758, "traffic": 10482, "percents": 23.64 },

      "C": { "count": 35928, "traffic": 7688, "percents": 18.17 },

      "T": { "count": 1503, "traffic": 80, "percents": 0.76 }

    }

  }

]

Get domain subdomains

GET https://api.seranking.com/v1/domain/subdomains
Cost: 100 credits per request

Retrieves a list of subdomains for a specified domain, along with key organic or paid search performance metrics. This endpoint helps identify which subdomains contribute the most to visibility, traffic, and value within a regional database.

Request parameters

Parameter	Type	Required	Default	Description
target	String	Yes	N/A	Root domain to analyze (e.g., `example.com`).
scope	String	Yes	N/A	Scope of analysis: • `base_domain` – aggregates subdomains under the registrable domain. • `domain` – aggregates subdomains under the specified host.
source	String	Yes	N/A	Country code of the regional keyword database (e.g., `us`). For acceptable values, see Regional database codes.
type	String	No	`organic`	Search traffic type for which data is retrieved: • `organic` – organic search traffic • `adv` – paid search traffic
order_field	String	No	`keywords_count`	Field by which results are sorted: • `keywords_count` • `traffic_sum` • `traffic_percent` • `price_sum`
order_type	String	No	`desc`	Sorting order: • `asc` – ascending • `desc` – descending
offset	Integer	No	N/A	Starting position for the paginated list.
limit	Integer	No	`1000`	Maximum number of subdomains to return in a single response (per page).
filter[domain_url]	String	No	N/A	JSON string specifying the subdomain or host text that must be included. See Text search JSON structure for formatting details.
filter[domain_traffic_percent][from]	Float	No	N/A	Minimum percentage of the total domain traffic contributed by the subdomain or URL to be included in the results.
filter[domain_traffic_percent][to]	Float	No	N/A	Maximum percentage of the total domain traffic contributed by the subdomain or URL to be included in the results.
filter[keywords_count][from]	Integer	No	N/A	Minimum number of ranking keywords for the subdomain or URL to be included in the results.
filter[keywords_count][to]	Integer	No	N/A	Maximum number of ranking keywords for the subdomain or URL to be included in the results.
filter[traffic_sum][from]	Integer	No	N/A	Minimum estimated monthly traffic for the subdomain or URL to be included in the results.
filter[traffic_sum][to]	Integer	No	N/A	Maximum estimated monthly traffic for the subdomain or URL to be included in the results.
filter[price_sum][from]	Float	No	N/A	Minimum estimated traffic value (PPC equivalent) for the subdomain or URL to be included in the results.
filter[price_sum][to]	Float	No	N/A	Maximum estimated traffic value (PPC equivalent) for the subdomain or URL to be included in the results.

Request example

Copy

curl -X GET 'https://api.seranking.com/v1/domain/subdomains?target=example.com&scope=base_domain&source=us&type=organic&order_field=keywords_count&order_type=desc&limit=1000' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

If the request is successful, the server returns a JSON array. Each object in this array represents a subdomain with aggregated metrics.

Parameter	Type	Description
url	String	Subdomain or root domain host (e.g., `blog.example.com`, `example.com`).
keywords_count	Integer	Number of keywords the subdomain ranks for.
traffic_sum	Integer	Estimated monthly traffic from ranking keywords.
traffic_percent	Float	Percentage of total domain traffic attributed to the subdomain.
price_sum	Float	Estimated traffic value (PPC equivalent).

Response example

Copy

[

  {

    "traffic_sum": 73909,

    "traffic_percent": 99.52,

    "price_sum": 149497.18,

    "keywords_count": 116181,

    "url": "example.com"

  },

  {

    "traffic_sum": 209,

    "traffic_percent": 0.28,

    "price_sum": 56.34,

    "keywords_count": 33,

    "url": "online.example.com"

  },

  {

    "traffic_sum": 146,

    "traffic_percent": 0.2,

    "price_sum": 175.67,

    "keywords_count": 1590,

    "url": "help.example.com"

  },

  {

    "traffic_sum": 0,

    "traffic_percent": 0,

    "price_sum": 0,

    "keywords_count": 1,

    "url": "academy.example.com"

  },

  {

    "traffic_sum": 0,

    "traffic_percent": 0,

    "price_sum": 0,

    "keywords_count": 4,

    "url": "visible.example.com"

  }

]

Get paid ads by keyword

GET https://api.seranking.com/v1/domain/ads
Cost: 100 credits per request

Retrieves an overview of paid advertisements (PPC ads) run by various domains for a specific target keyword. The method shows which domains are advertising on that keyword, the extent of their advertising efforts over a period, and details of their ad creatives.

Request parameters

Parameter	Type	Required	Default	Description
source	String	Yes	N/A	Country code of the regional keyword database (e.g., `us`). For acceptable values, see Regional database codes.
keyword	String	Yes	N/A	Specific keyword for which to retrieve paid ad data. Accepts any valid keyword string (e.g., `new york hotels`).
from	String	No	N/A (implies current/all available data)	Starting year and month for the data retrieval period, formatted as YYYY-MM (e.g., `2017-01`).
to	String	No	N/A (implies current/all available data)	Ending year and month for the data retrieval period, formatted as YYYY-MM (e.g., `2023-12`).
page	Integer	No	`1`	Page number for paginated results when retrieving domains advertising on the specified keyword (e.g., `1`). Positive integer.
limit	Integer	No	`100`	Maximum number of domains advertising on the specified keyword to return per page. Accepts values from 1 to 100 (e.g., `20`).

Request example

Copy

curl -X GET 'https://api.seranking.com/v1/domain/ads?source=us&keyword=nyc+hotels&from=2023-01&to=2023-12&limit=10' \

-H 'Authorization: Token YOUR_API_KEY'

Response parameters

If successful, the server returns a JSON array. Each object in the array represents a unique domain that has run paid ads for the specified keyword and contains an overview of that domain’s advertising activity for that keyword.

Parameter	Type	Description
domain	String	Domain name that ran ads for the target keyword (e.g., `hotels.com`).
ads_count	Integer	Number of unique ad creatives or instances observed from this domain for the target keyword within the specified period (e.g., `19`).
keywords_count	Integer	Number of other keywords the domain was also seen advertising on, providing context on the advertiser’s breadth (e.g., `78972`).
traffic_sum	Integer	Estimation of the total traffic this domain received from its ads for all its keywords, not just the target one (e.g., `3565364`).
price_sum	Float	Estimated traffic value (PPC equivalent) from paid keywords.
snippets.position	Integer	Observed position of the ad snippet on the SERP (e.g., `2`).
snippets.snippet_title	String	Title text of the specific advertisement (e.g., `Booking`).
snippets.snippet_description	String	Descriptive text body of the specific advertisement (e.g., `Stay 10 nights & get 1 free!...`).
snippets.snippet_display_url	String	URL displayed in the specific advertisement (e.g., `www.hotels.com/`).
snippets.snippet_count	Integer	Count or frequency of this specific snippet being observed (e.g., `1`).
snippets.url	String	Actual destination URL (landing page) of the specific advertisement (e.g., `https://www.hotels.com/`).

Response example

Copy

[

  {

    "domain": "examplehotelchain.com",

    "ads_count": 5,

    "keywords_count": 250,

    "traffic_sum": 150000,

    "price_sum": 75000.5,

    "snippets": {

      "2023-05": {

        "position": 1,

        "snippet_title": "Luxury London Stays | Example Hotels‎",

        "snippet_description": "Experience unparalleled luxury. Book your 5-star hotel in London today. Exclusive offers available for a limited time.",

        "snippet_display_url": "www.examplehotelchain.com/london",

        "snippet_count": "1",

        "url": "https://www.examplehotelchain.com/offers/london-luxury"

      }

    }

  }

]

Get paid ads for domain

GET https://api.seranking.com/v1/domain/ads
Cost: 100 credits per request

Retrieves an overview of keywords a specific target domain is bidding on in paid search auctions. It details the ads run by this domain for those keywords, including ad copy, landing pages, and observed performance metrics over a specified period.

Request parameters

Parameter	Type	Required	Default	Description
source	String	Yes	N/A	Country code of the regional keyword database (e.g., `us`). For acceptable values, see Regional database codes.
domain	String	Yes	N/A	Specific domain for which to retrieve its paid ad data (e.g., `booking.com`).
from	String	No	N/A (implies current/all available data)	Starting year and month for the data retrieval period, formatted as YYYY-MM (e.g., `2017-01`).
to	String	No	N/A (implies current/all available data)	Ending year and month for the data retrieval period, formatted as YYYY-MM (e.g., `2018-12`).
page	Integer	No	`1`	Page number for paginated results when retrieving keywords the domain is advertising on (e.g., `1`). Positive integer.
limit	Integer	No	`100`	Maximum number of keywords the domain is advertising on to return per page. Accepts values from 1 to 100 (e.g., `100`).

Request example

Copy

curl -X GET 'https://api.seranking.com/v1/domain/ads?source=us&domain=booking.com&from=2023-01&to=2023-12&limit=10' \

-H 'Authorization: Token YOUR_API_KEY'

Response parameters

If successful, the server returns a JSON array. Each object in the array represents a unique keyword that the specified domain has targeted with paid ads. It includes performance metrics for that keyword and details of the ad snippets run by the domain for that keyword.

Parameter	Type	Description
keyword	String	Keyword phrase that the specified domain was advertising on (e.g., `locanda vivaldi venice`).
ads_count	Integer	Number of unique ad creatives or instances observed from the specified domain for this keyword within the given period (e.g., `24`).
competition	Float	Score representing keyword competition. Float from `0.00` (low) to `1.00` (high).
cpc	Float	Average CPC (Cost Per Click) for the keyword (e.g., `5.64`).
volume	Integer	Average monthly search volume for this keyword (e.g., `100`).
snippets.position	Integer	Observed position of the ad snippet on the SERP (e.g., `2`).
snippets.snippet_title	String	Title text of the specific advertisement (e.g., `Locanda Vivaldi, Venice - Booking.com`).
snippets.snippet_description	String	Descriptive text body of the specific advertisement (e.g., `Book at Locanda Vivaldi, Venice. No reservation costs...`).
snippets.snippet_display_url	String	URL displayed in the specific advertisement (e.g., `www.booking.com/hotel/it/locanda-vivaldi.en.html?a`).
snippets.snippet_count	Integer	Count or frequency of the specific snippet being observed (e.g., `1`).
snippets.snippet_num	Integer	Numerical identifier for the specific ad snippet (e.g., `125`).
snippets.url	String	Actual destination URL (landing page) of the specific advertisement (e.g., `http://www.booking.com/hotel/it/locanda-vivaldi.en.html?aid=311088`).

Response example

Copy

[

  {

    "keyword": "locanda vivaldi venice",

    "ads_count": 24,

    "competition": "0.39",

    "cpc": "5.64",

    "volume": "100",

    "snippets": {

      "2017-01": {

        "position": "2",

        "snippet_title": "Locanda Vivaldi, Venice – Booking.com‎",

        "snippet_description": "Book at Locanda Vivaldi, Venice. No reservation costs. Great rates Amenities: Free Wifi, Non Smoking Rooms, 24 Hour Front Desk, Air Conditioning",

        "snippet_display_url": "www.booking.com/hotel/it/locanda-vivaldi.en.html?a",

        "snippet_count": "1",

        "snippet_num": 125,

        "url": "http://www.booking.com/hotel/it/locanda-vivaldi.en.html?aid=311088"

      }

    }

  }

]

Get domain competitors

GET https://api.seranking.com/v1/domain/competitors
Cost: 100 credits per request

Retrieves a list of competitor domains for a specified target domain. The list can be tailored to show organic or paid competitors, and can optionally include or exclude major industry players. Furthermore, the level of detail in the response can be adjusted to include basic information or more extensive statistics for each competitor. The maximum number of competitors returned is 500.

Request parameters

Parameter	Type	Required	Default	Description
source	String	Yes	N/A	Country code of the regional keyword database (e.g., `us`). For acceptable values, see Regional database codes.
domain	String	Yes	N/A	Primary domain for which to find competitors (e.g., `seranking.com`).
type	String	No	`organic`	Search traffic type for which data is retrieved: • `organic` – organic search traffic • `adv` – paid search traffic

Request example

Copy

curl -X GET 'https://api.seranking.com/v1/domain/competitors?source=us&domain=yourtargetdomain.com&type=organic' \

-H 'Authorization: Token YOUR_API_KEY'

Response parameters

If the request is successful, the server returns a JSON array. Each object in this array represents a competitor domain.

Parameter	Type	Description
domain	String	Domain name of the competitor (e.g., `tripadvisor.com`).
common_keywords	Integer	Number of keywords for which both the analyzed domain and the competitor rank (e.g., `1076`).
domain_relevance	Float	A score indicating how closely the competitor’s keyword profile overlaps with the analyzed domain (e.g., `10.98`). Higher values indicate greater relevance.
total_keywords	Integer	Number of keywords for which the competitor domain ranks within Google’s top 100 results in the specified database (e.g., `2084`).
missing_keywords	Integer	Number of keywords for which the competitor ranks but the analyzed domain does not (e.g., `19511`). Calculated as `total_keywords - common_keywords`.
traffic_sum	Integer	Estimated monthly traffic volume the competitor receives from its ranking keywords (e.g., `291`). This is typically calculated based on expected CTR, search volume, and positions.
price_sum	Float	Estimated traffic value (PPC equivalent) of the competitor’s traffic.

Response examples

Copy

[

  {

    "domain": "seoreviewtools.com",

    "common_keywords": 29926,

    "domain_relevance": 10.98,

    "total_keywords": 49437,

    "missing_keywords": 19511,

    "traffic_sum": 40619,

    "price_sum": 68705.61

  },

  {

    "domain": "keyword-tools.org",

    "common_keywords": 10110,

    "domain_relevance": 2.7,

    "total_keywords": 11183,

    "missing_keywords": 1073,

    "traffic_sum": 19544,

    "price_sum": 26071.28

  }

]

Analyze keyword overlap and gaps

GET https://api.seranking.com/v1/domain/keywords/comparison
Cost: 100 credits per request

Analyzes and compares the keyword rankings of two websites using either domains or full URLs. It can find keywords they have in common or identify a ‘keyword gap’— keywords for which one site ranks, but the other does not. This is useful for competitive analysis and identifying ranking opportunities.

Request parameters

Note: Either domain or url must be specified. When one option is provided, the other is ignored.

Parameter	Type	Required	Default	Description
source	String	Yes	N/A	Country code of the regional keyword database (e.g., `us`). For acceptable values, see Regional database codes.
domain	String	No	N/A	Primary domain for the comparison (e.g., `booking.com`).
url	String	No	N/A	Primary full URL for the comparison (e.g., `https://www.booking.com`).
compare	String	Yes	N/A	Competitor domain or full URL to compare against the primary domain or URL. Must match the type of the primary parameter (`domain` or `url`).
type	String	No	`organic`	Search traffic type for which data is retrieved: • `organic` – organic search traffic • `adv` – paid search traffic
page	Integer	No	`1`	Page number for paginated results when retrieving keywords (e.g., `1`). Positive integer.
limit	Integer	No	`100`	Maximum number of keywords to return per page (e.g., `50`). Accepts values from 1 to 1000.
diff	String	No	`0`	Controls the comparison mode. Accepts values: 0, 1. See the section below for a detailed explanation.
order_field	String	No	`keyword`	Field by which results are sorted: • `keyword` • `volume` • `cpc` • `competition` • `difficulty` • `position`
order_type	String	No	`asc`	Sorting order: • `asc` – ascending • `desc` – descending
cols	String	No	All relevant by default	Comma-separated list of response fields to include. If omitted, a default set of relevant columns is returned.
filter[keyword]	String	No	N/A	Case-insensitive substring match on the keyword text (e.g., `vegas`).
filter[multi_keyword_included]	String	No	N/A	JSON string specifying keyword text that must be included. See Text search JSON structure for formatting details.
filter[multi_keyword_excluded]	String	No	N/A	JSON string specifying keyword text that must be excluded. See Text search JSON structure for formatting details.
filter[volume][from]	Integer	No	N/A	Minimum monthly search volume for keywords to be included. Non-negative integer.
filter[volume][to]	Integer	No	N/A	Maximum monthly search volume for keywords to be included. Non-negative integer.
filter[cpc][from]	Float	No	N/A	Minimum CPC (Cost Per Click) value (e.g., `0.1`). Non-negative float.
filter[cpc][to]	Float	No	N/A	Maximum CPC (Cost Per Click) value (e.g., `2.5`). Non-negative float.
filter[competition][from]	Float	No	N/A	Minimum competition score. Float from `0.00` (low) to `1.00` (high).
filter[competition][to]	Float	No	N/A	Maximum competition score. Float from `0.00` (low) to `1.00` (high).
filter[difficulty][from]	Integer	No	N/A	Minimum keyword difficulty score (0–100).
filter[difficulty][to]	Integer	No	N/A	Maximum keyword difficulty score (0–100).
filter[intents]	String	No	N/A	Comma-separated list of search intent codes. Returns keywords matching any of the specified intents (OR logic): • `I` – informational • `N` – navigational • `T` – transactional • `C` – commercial • `L` – local
filter[serp_features]	String	No	N/A	Comma-separated list of SERP feature codes. Returns keywords where any of the specified features is present on the SERP (OR logic), e.g., `sitelinks,hotel_pack,people_also_ask`. For acceptable values, see SERP features.

Understanding the `diff` parameter

The diff parameter controls the comparison mode by defining which set of keywords to return. For these examples, let A be the primary domain and B be the compare domain.

`diff=0`: common keywords (A ∩ B)

Returns keywords for which both the primary domain (A) and the compare domain (B) rank.

`diff=1`: keyword gap (A – B)

Returns keywords for which the primary domain (A) ranks, but the compare domain (B) does not.

💡 Pro tip: How to find your competitor’s unique keywords (B – A)

To find the keywords for which the compare domain ranks but your primary domain does not, simply swap the domains in your request. Set the competitor’s domain as the primary domain and your domain as the compare domain, while keeping diff=1.

For example, to see keywords hotels.com has that booking.com lacks, request: ...&domain=hotels.com&compare=booking.com&diff=1...

Request examples

Comparing domain names

Copy

curl -X GET 'https://api.seranking.com/v1/domain/keywords/comparison?source=us&domain=booking.com&compare=hotels.com&type=organic&diff=0&order_field=volume&order_type=desc' \

-H 'Authorization: Token YOUR_API_KEY'

Comparing URLs

Copy

curl -X GET 'https://api.seranking.com/v1/domain/keywords/comparison?source=us&url=https://www.booking.com&compare=https://www.hotels.com&type=organic&diff=1&order_type=desc&order_field=volume' \

-H 'Authorization: Token YOUR_API_KEY'

Comparing URLs

Copy

curl -X GET 'https://api.seranking.com/v1/domain/keywords/comparison?source=us&domain=booking.com&compare=hotels.com&type=organic&diff=0&filter[intents]=T&filter[volume][from]=1000&cols=keyword,volume,intents,position,compare_position' \

-H 'Authorization: Token YOUR_API_KEY'

Response parameters

If the request is successful, the server returns a JSON array. Each object in this array represents a keyword and includes metrics for both the primary domain and the compare domain (where applicable, depending on the diff mode).

Parameter	Type	Description
keyword	String	Analyzed keyword phrase (e.g., `haworth hotel holland mi`).
volume	Integer	Average monthly number of Google searches for the specified keyword (e.g., `10`).
cpc	Float	CPC (Cost Per Click) for the keyword (e.g., `3.01`).
competition	Float	Score representing keyword competition. Float from `0.00` (low) to `1.00` (high).
difficulty	Integer	Keyword difficulty for this keyword (from `0` to `100`).
total_sites	Integer	Number of websites appearing in the search results for the query (e.g., `94`).
position	Integer	Ranking position of the primary domain for the keyword (e.g., `4`). Can be null if `diff=1` and the primary domain doesn’t rank.
url	String	URL of the primary domain’s page that ranks for this keyword (e.g., `https://www.booking.com/hotel/us/haworth-inn-center.html`). Can be null if `diff=1`.
price	Float	Estimated cost/value of the traffic the primary domain receives from this keyword (e.g., `2.44`). Can be null if `diff=1`.
traffic	Float	Estimated traffic the primary domain receives from this keyword (e.g., `0.81`). Can be null if `diff=1`.
compare_position	Integer	Ranking position of the `compare` domain for this keyword (e.g., `5`).
compare_url	String	URL of the `compare` domain’s page that ranks for this keyword (e.g., `https://www.hotels.com/ho576868/haworth/`).
compare_price	Float	Estimated cost/value of the traffic the `compare` domain receives from this keyword (e.g., `1.84`).
compare_traffic	Float	Estimated traffic the `compare` domain receives from this keyword (e.g., `0.61`).
intents	Array	Search intent codes associated with the keyword. Possible values: • `I` – informational • `N` – navigational • `T` – transactional • `C` – commercial • `L` – local
serp_features	Array	SERP features present for this keyword on the SERP (e.g., `sitelinks`, `hotel_pack`, `people_also_ask`). For acceptable values, see SERP features.

Response examples

The examples below show how the output differs depending on the diff parameter value.

Common keywords (`diff=0`)

This request finds keywords that booking.com and hotels.com have in common.

Copy

curl -X GET 'https://api.seranking.com/v1/domain/keywords/comparison?source=us&domain=booking.com&compare=hotels.com&type=organic&diff=0&limit=1' \

-H 'Authorization: Token YOUR_API_KEY'

Copy

[

  {

        "keyword": "403",

        "volume": 33100,

        "cpc": 0.11,

        "competition": 0.05,

        "difficulty": 96,

        "total_sites": 0,

        "intents": [

            "I"

        ],

        "serp_features": [

            "video",

            "images",

            "knowledge_graph",

            "sge"

        ],

        "compare_position": 21,

        "compare_url": "https://seranking.com/blog/401-vs-403-error-codes/",

        "compare_price": 3.52,

        "compare_traffic": 32,

        "position": 25,

        "url": "https://www.wix.com/encyclopedia/definition/error-403",

        "price": 7.81,

        "traffic": 71

    }

]

Keyword gap (`diff=1`)

This request finds keywords for which the primary domain (booking.com) ranks, but the compare domain (hotels.com) does not.

Copy

curl -X GET 'https://api.seranking.com/v1/domain/keywords/comparison?source=us&domain=booking.com&compare=hotels.com&type=organic&diff=1&limit=1' \

-H 'Authorization: Token YOUR_API_KEY'

Copy

[

  {

        "keyword": "403",

        "volume": 33100,

        "cpc": 0.11,

        "competition": 0.05,

        "difficulty": 96,

        "total_sites": 0,

        "intents": [

            "I"

        ],

        "serp_features": [

            "video",

            "images",

            "knowledge_graph",

            "sge"

        ],

        "compare_position": 21,

        "compare_url": "https://seranking.com/blog/401-vs-403-error-codes/",

        "compare_price": 3.52,

        "compare_traffic": 32,

        "position": 25,

        "url": "https://www.wix.com/encyclopedia/definition/error-403",

        "price": 7.81,

        "traffic": 71

    }

]

Text search JSON structure

The text search structure allows for the creation of complex text searches by providing a JSON string in the format array<array<object>>.

The first (outer) layer of the array corresponds to elements separated by logical OR.
The second (inner) layer of the array corresponds to elements with logical AND.

Each object within the inner array has the following structure:

Copy

{"type": "begins","value": "google"}

Object properties

Name	Description
object.value	Contains the text value to be searched.
object.type	Specifies the type of search to be performed.

List of possible object.type variants

Name	Description
begins	Searched text should start with the specified value.
contains	Searched text should contain the specified value anywhere within the text.
ends	Searched text should end with the specified value.
exact	Searched text should exactly match the specified value.

Example of a complex JSON filter structure

To find keywords that contain “seo tools” AND (begin with “free” OR begin with “best”), the JSON for filter[multi_keyword_included] would be:

Copy

[

  [

    {"type": "contains","value": "seo tools"},

    {"type": "begins","value": "free"}

  ],

  [

    {"type": "contains","value": "seo tools"},

    {"type": "begins","value": "best"}

  ]

]

This example illustrates the OR (outer array) and AND (inner array) logic. The filter[url] parameter is simpler as it doesn’t use the OR logic and only accepts a single inner array, e.g., [[{"type":"contains","value":"/blog"}]].

Domain Analysis

Get domain overview by region

Request parameters

Request example

Response parameters

Response example

Get worldwide domain overview

Request parameters

Request example

Response parameters

Response example

Get worldwide URL overview

Request parameters

Request example

Response parameters

Response example

Get domain traffic and keyword history

Request parameters

Request examples

Response parameters

Response examples

Get domain keyword rankings

Request parameters

Required fields

Search type, pagination, ordering

Historical snapshots (year / month)

Filters

Position-change filter

Range filters (from / to)

Text filters

Intent filter

SERP-feature filters — pick the right one

Response parameters

Current

Default response columns

Field reference

Example – organic, current

Historical (year + month)

Example – historical

Examples

1. Domain, paid search, sort by CPC

2. Specific URL, organic, with SERP feature present

3. AI Overview cites the analyzed domain

4. AI Overview present but does NOT cite the domain (citation-gap opportunity)

5. Either AI Overview OR Reviews cites the domain (multi-value)

6. Historical snapshot — same domain, 6 months ago

7. Position-change feed — winners and losers in one call

8. Long-tail informational keywords with low difficulty

Get domain pages

Request parameters

Request example

Response parameters

intents object

Response example

Get domain subdomains

Request parameters

Request example

Response parameters

Response example

Get paid ads by keyword

Request parameters

Request example

Response parameters

Response example

Get paid ads for domain

Request parameters

Request example

Response parameters

Response example

Get domain competitors

Request parameters

Request example

Response parameters

Response examples

Analyze keyword overlap and gaps

Request parameters

Understanding the diff parameter

diff=0: common keywords (A ∩ B)

diff=1: keyword gap (A – B)

Request examples

Range filters (`from` / `to`)

Historical (`year` + `month`)

`intents` object

Understanding the `diff` parameter

`diff=0`: common keywords (A ∩ B)

`diff=1`: keyword gap (A – B)

Common keywords (`diff=0`)

Keyword gap (`diff=1`)