Semrush

Learn how to use Semrush with Composio

Overview

Enum

SEMRUSH

Description

Semrush is a popular SEO tool suite that specializes in keyword research, competitor analysis, and Google Ad campaign optimization.

Authentication Details

api_key
stringRequired

Actions

This report shows unique pages of the analyzed domain ranking in google’s top 100 organic search results.

Action Parameters

domain
stringRequired
database
stringRequired
display_limit
integerDefaults to 10000
display_offset
integer
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
display_date
string
export_columns
arrayDefaults to ['Ur', 'Pc', 'Tg', 'Tr', 'Ipu', 'Ip0', 'Ip1', 'Ip2', 'Ip3', 'Itu', 'It0', 'It1', 'It2', 'It3', 'Sr', 'St']
display_sort
stringDefaults to pc_desc
display_filter
array

Action Response

data
string
successful
boolean
error

This report shows the referring domain distribution depending on the top-level domain (tld) type.

Action Parameters

target
stringRequired
target_type
stringRequired
export_columns
arrayDefaults to ['zone', 'domains_num', 'backlinks_num']
display_sort
stringDefaults to domains_num_desc
display_limit
integerDefaults to 10000
display_offset
integer

Action Response

data
string
successful
boolean
error

This report provides a summary of up to 100 keywords, including their volume, cpc, competition level, and the number of results in a chosen regional database.

Action Parameters

phrase
stringRequired
database
stringRequired
display_date
string
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
export_columns
arrayDefaults to ['Ph', 'Nq', 'Cp', 'Co', 'Nr', 'Td', 'In', 'Kd']

Action Response

data
object
successful
boolean
error

This report returns only monthly historical trends of multiple backlinks and referring domains for the queried domain. when you run a query for a domain, in return, in each line, you receive a date (unix timestamp) and the number of backlinks and referring domains the queried domain had at that time. results are sorted by date from the most recent to the oldest.

Action Parameters

target
stringRequired
target_type
stringRequired
export_columns
arrayDefaults to ['date', 'backlinks_num', 'domains_num', 'score']
display_limit
integer
display_offset
integer

Action Response

data
string
successful
boolean
error

This report lists keywords that bring users to a domain via google’s top 100 organic search results. you can get monthly rankings from as far back as 2012–2016, depending on the database, or daily rankings for the last 31 days (with display daily).

Action Parameters

domain
stringRequired
database
stringRequired
display_limit
integerDefaults to 10000
display_offset
integer
export_escape
integerDefaults to 1
display_date
string
display_daily
integer
export_columns
arrayDefaults to ['Ph', 'Po', 'Pp', 'Pd', 'Nq', 'Cp', 'Ur', 'Tr', 'Tg', 'Tc', 'Co', 'Nr', 'Td', 'Kd', 'Fp', 'Fk', 'Ts', 'In', 'Pt']
display_sort
stringDefaults to po_desc
display_positions
string
display_filter
array
display_positions_type
stringDefaults to organic

Action Response

data
string
successful
boolean
error

This report lists domains the requested domain is competing against in google’s paid search results with product listing ads (pla).

Action Parameters

domain
stringRequired
database
stringRequired
display_limit
integerDefaults to 10000
display_offset
integer
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
export_columns
arrayDefaults to ['Dn', 'Cr', 'Np', 'Sh', 'Ad', 'At', 'Ac', 'Or']
display_sort
stringDefaults to np_desc

Action Response

data
string
successful
boolean
error

This report shows the referring domain distribution by country. the ip address of a domain is used to define a country.

Action Parameters

target
stringRequired
target_type
stringRequired
export_columns
arrayDefaults to ['country', 'domains_num', 'backlinks_num']
display_sort
stringDefaults to domains_num_desc
display_limit
integerDefaults to 10000
display_offset
integer

Action Response

data
string
successful
boolean
error

This report lists anchor texts used in backlinks leading to the queried domain, root domain, or url. it also includes the number of backlinks and referring domains per anchor.

Action Parameters

target
stringRequired
target_type
stringRequired
export_columns
arrayDefaults to ['anchor', 'domains_num', 'backlinks_num', 'first_seen', 'last_seen']
display_sort
stringDefaults to domains_num_desc
display_limit
integerDefaults to 10000
display_offset
integer

Action Response

data
string
successful
boolean
error

This report shows keywords a domain has bid on in the last 12 months and its positions in paid search results.

Action Parameters

domain
stringRequired
database
stringRequired
display_limit
integerDefaults to 10000
display_offset
integer
export_escape
integerDefaults to 1
export_columns
arrayDefaults to ['Ph', 'Dt', 'Po', 'Cp', 'Nq', 'Tr', 'Ur', 'Tt', 'Ds', 'Vu', 'Cv']
display_sort
stringDefaults to cv_desc
display_filter
array

Action Response

data
string
successful
boolean
error

This report returns a list of categories that the queried domain belongs to. when you run a query for a domain, in each line, you get a category and a rating. the rating reflects the level of confidence that this domain belongs to this category (ranging from 0 to 1). the results are sorted by the rating.

Action Parameters

target
stringRequired
target_type
stringRequired
export_columns
arrayDefaults to ['category_name', 'rating']
display_limit
integer
display_offset
integer

Action Response

data
string
successful
boolean
error

Retrieves pla search keywords data for a given target domain from semrush’s api. this endpoint provides detailed information about the pla search keywords for the specified target. it is useful for ppc analysis and understanding the performance of a domain in pla search engine results.

Action Parameters

domain
stringRequired
database
stringRequired
display_limit
integerDefaults to 10000
display_offset
integer
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
export_columns
arrayDefaults to ['Ph', 'Po', 'Pp', 'Pd', 'Nq', 'Sn', 'Ur', 'Tt', 'Pr', 'Ts']
display_sort
stringDefaults to po_desc
display_filter
array

Action Response

data
string
successful
boolean
error

The report lists broad matches and alternate search queries, including particular keywords or keyword expressions.

Action Parameters

phrase
stringRequired
database
stringRequired
display_limit
integerDefaults to 10000
display_offset
integer
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
display_date
string
export_columns
arrayDefaults to ['Ph', 'Nq', 'Cp', 'Co', 'Nr', 'Td', 'Fk', 'In', 'Kd']
display_sort
stringDefaults to nq_desc
display_filter
array

Action Response

data
string
successful
boolean
error

This report lists domains ranking in google’s top 100 organic search results with a requested keyword.

Action Parameters

phrase
stringRequired
database
stringRequired
display_limit
integerDefaults to 10000
display_offset
integer
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
display_date
string
export_columns
arrayDefaults to ['Po', 'Pt', 'Dn', 'Ur', 'Fk', 'Fp', 'Fl']
positions_type
stringDefaults to organic

Action Response

data
string
successful
boolean
error

The report lists phrase questions relevant to a queried term in a chosen database.

Action Parameters

phrase
stringRequired
database
stringRequired
display_limit
integerDefaults to 10000
display_offset
integer
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
export_columns
arrayDefaults to ['Ph', 'Nq', 'Cp', 'Co', 'Nr', 'Td', 'In', 'Kd']
display_sort
stringDefaults to nq_desc
display_filter
array

Action Response

data
string
successful
boolean
error

This report shows domains that have bid on a requested keyword in the last 12 months and their positions in paid search results.

Action Parameters

phrase
stringRequired
database
stringRequired
display_limit
integerDefaults to 10000
display_offset
integer
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
display_date
string
export_columns
arrayDefaults to ['Dn', 'Dt', 'Po', 'Ur', 'Tt', 'Ds', 'Vu', 'At', 'Ac', 'Ad']

Action Response

data
string
successful
boolean
error

This report provides a keyword summary, including its volume, cpc, competition level, and the number of results in a chosen regional database.

Action Parameters

phrase
stringRequired
database
stringRequired
display_date
string
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
export_columns
arrayDefaults to ['Ph', 'Nq', 'Cp', 'Co', 'Nr', 'Td', 'In', 'Kd']

Action Response

data
object
successful
boolean
error

This report shows unique ad copies semrush noticed when the domain ranked in google’s paid search results for keywords from our databases.

Action Parameters

domain
stringRequired
database
stringRequired
display_limit
integerDefaults to 10000
display_offset
integer
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
export_columns
arrayDefaults to ['Ph', 'Un', 'Tt', 'Ds', 'Vu', 'Ur', 'Pc', 'Ts']
display_sort
stringDefaults to pc_desc
display_filter
array

Action Response

data
string
successful
boolean
error

This report returns a list of categories that the referring domains of the queried domain belong to. when you run a query for a domain, in each line, you get a category and the number of domains in that category with at least one link pointing to the queried domain. the results are sorted by the number of referring domains in descending order. this report is generated based on the first 10,000 referring domains for the queried domain.

Action Parameters

target
stringRequired
target_type
stringRequired
export_columns
arrayDefaults to ['category_name', 'rating']
display_limit
integer
display_offset
integer

Action Response

data
string
successful
boolean
error

This report shows subdomains of the analyzed domain ranking in google’s top 100 organic search results.

Action Parameters

domain
stringRequired
database
stringRequired
display_limit
integerDefaults to 10000
display_offset
integer
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
display_date
string
export_columns
arrayDefaults to ['Ur', 'Pc', 'Tg', 'Tr', 'Sr', 'St']
display_sort
stringDefaults to pc_desc

Action Response

data
string
successful
boolean
error

This report lists ip addresses where backlinks to a domain, root domain, or url are coming from.

Action Parameters

target
stringRequired
target_type
stringRequired
export_columns
arrayDefaults to ['ip', 'country', 'domains_num', 'backlinks_num', 'first_seen', 'last_seen']
display_sort
stringDefaults to backlinks_num_desc
display_limit
integerDefaults to 10000
display_offset
integer

Action Response

data
string
successful
boolean
error

This report allows users to compare up to five domains by common keywords, unique keywords, all keywords, or search terms that are unique to the first domain.

Action Parameters

domains
stringRequired
database
stringRequired
display_limit
integerDefaults to 10000
display_offset
integer
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
display_date
string
export_columns
arrayDefaults to ['Ph', 'P0', 'P1', 'P2', 'P3', 'P4', 'Nr', 'Cp', 'Nq', 'Kd', 'Co', 'Td']
display_sort
stringDefaults to p0_desc
display_filter
array

Action Response

data
string
successful
boolean
error

This report returns the distribution of referring domains by authority score. when you run a query for a domain, in return, for each authority score value from 0 to 100, you receive a number of domains with at least one link pointing to the queried domain.

Action Parameters

target
stringRequired
target_type
stringRequired

Action Response

data
string
successful
boolean
error

This report lists keywords that bring users to a domain via google’s paid search results.

Action Parameters

domain
stringRequired
database
stringRequired
display_limit
integerDefaults to 10000
display_offset
integer
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
display_date
string
export_columns
arrayDefaults to ['Ph', 'Po', 'Pp', 'Pd', 'Ab', 'Nq', 'Cp', 'Tg', 'Tr', 'Tc', 'Co', 'Nr', 'Td', 'Tt', 'Ds', 'Vu', 'Ur', 'Ts', 'Un']
display_sort
stringDefaults to po_desc
display_positions
string
display_filter
array

Action Response

data
string
successful
boolean
error

This report lists domains pointing to the queried domain, root domain, or url.

Action Parameters

target
stringRequired
target_type
stringRequired
export_columns
arrayDefaults to ['domain_ascore', 'domain', 'backlinks_num', 'ip', 'country', 'first_seen', 'last_seen']
display_sort
stringDefaults to backlinks_num_desc
display_limit
integerDefaults to 10000
display_offset
integer
display_filter
array

Action Response

data
string
successful
boolean
error

This report lists domains ranking in google’s paid search results with a requested keyword.

Action Parameters

phrase
stringRequired
database
stringRequired
display_limit
integerDefaults to 10000
display_offset
integer
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
display_date
string
export_columns
arrayDefaults to ['Dn', 'Ur', 'Vu']

Action Response

data
string
successful
boolean
error

Compare your backlink profile and link-building progress with those of your competitors.

Action Parameters

targets
arrayRequired
target_types
arrayRequired
export_columns
arrayDefaults to ['target', 'target_type', 'ascore', 'backlinks_num', 'domains_num', 'ips_num', 'follows_num', 'nofollows_num', 'texts_num', 'images_num', 'forms_num', 'frames_num']

Action Response

data
string
successful
boolean
error

This report shows product listing ad (pla) copies semrush noticed when the domain ranked in google’s paid search results for keywords from our databases.

Action Parameters

domain
stringRequired
database
stringRequired
display_limit
integerDefaults to 10000
display_offset
integer
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
export_columns
arrayDefaults to ['Tt', 'Pr', 'Ur', 'Pc', 'Un', 'Ts']
display_sort
stringDefaults to pr_desc
display_filter
array

Action Response

data
string
successful
boolean
error

This report shows indexed pages of the queried domain.

Action Parameters

target
stringRequired
target_type
stringRequired
export_columns
arrayDefaults to ['ascore', 'neighbour', 'similarity', 'common_refdomains', 'domains_num', 'backlinks_num']
display_sort
stringDefaults to common_backlinks_num_desc
display_limit
integerDefaults to 10000
display_offset
integer

Action Response

data
string
successful
boolean
error

This report provides keyword difficulty, an index that helps to estimate how difficult it would be to seize competitors’ positions in organic search within google’s top 10 with a queried search term.

Action Parameters

phrase
stringRequired
database
stringRequired
export_escape
integerDefaults to 1
export_columns
arrayDefaults to ['Ph', 'Kd']

Action Response

data
string
successful
boolean
error

This report provides a keyword summary, including its volume, cpc, competition level, and the number of results in all regional databases.

Action Parameters

phrase
stringRequired
database
string
export_escape
integerDefaults to 1
export_decode
integerDefaults to 1
export_columns
arrayDefaults to ['Dt', 'Db', 'Ph', 'Nq', 'Cp', 'Co', 'Nr', 'In', 'Kd']

Action Response

data
object
successful
boolean
error

This report shows indexed pages of the queried domain.

Action Parameters

target
stringRequired
target_type
stringRequired
export_columns
arrayDefaults to ['source_url', 'source_title', 'response_code', 'backlinks_num', 'domains_num', 'last_seen', 'external_num', 'internal_num']
display_sort
stringDefaults to backlinks_num_desc
display_limit
integerDefaults to 10000
display_offset
integer

Action Response

data
string
successful
boolean
error