logo-small logo-small_halloween

SEMrush API
3.0

Any questions?
US customers, Toll-Free
+1-855-814-4510
offline
Monday through Friday (ET)
Europe customers, Toll-Free
United Kingdom
España
France
Italia
Россия
0-808-189-3160
offline
Monday through Friday in your local time

Accounts API

 
queries_api
Price: Free

This report shows the last requests sent by a user to SEMrush via API. It also provides data on the time of the request, the chosen database, the type of report requested, the user’s IP address, and the cost per line.

Endpoint

http://logs.backend.semrush.com/

Request parameters

NameValueDescription
type*queries_apiA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
action*report
export*api
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_columns Ts, Db, Hs, Rt, Qu, Ip, Of, Li, Lc Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_filter Filters for columns. Ts, Db, Hs, Rt, Qu

Request example

http://logs.backend.semrush.com/?action=report&type=queries_api&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_filter=%2B%7CDb%7C%7Cus&display_limit=3&export=api&export_columns=Ts,Db,Hs,Rt,Qu,Ip,Of,Li,Lc

Response example

"Time";"DB";"Historical";"Report type";"Query";"IP";"Offset";"Limit";"API line cost" "1404135852";"us";"0";"domain_rank";"seobook.com";"192.243.51.71";"0";"0";"10" "1404135405";"us";"0";"phrase_organic";"seo";"192.243.51.71";"0";"10";"10" "1404134484";"us";"0";"url_adwords";"http://www.amazon.com/";"84.52.114.132";"0";"5";"20"
 
queries_export
Price: Free

This report shows the last requests to export data via the SEMrush user interface. It also provides data on the time of the request, the chosen database, the type of report requested, and the user’s IP address.

Endpoint

http://logs.backend.semrush.com/

Request parameters

NameValueDescription
type*queries_exportA type of report
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.
action*report
export*api
display_limitintegerThe number of results returned to a request; if this parameter is not specified or equal to 0, the default value will be 10,000 lines.
display_offsetintegerThis parameter allows you to skip a specified number of results before sending a report.
Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
export_columns Ts, Db, Hs, Rt, Qu, Ip Required columns must be separated by commas; if this parameter is not specified, default columns will be sent.
display_filter Filters for columns. Ts, Db, Hs, Rt, Qu

Request example

http://logs.backend.semrush.com/?action=report&type=queries_export&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&display_filter=%2B%7CDb%7C%7Cus&display_limit=3&export=api&export_columns=Ts,Db,Hs,Rt,Qu,Ip

Response example

"Time";"DB";"Historical";"Report type";"Query";"IP" "1403253965";"us";"0";"domain_organic";"nationwide.com";"84.52.114.132" "1403188033";"us";"0";"domain_organic";"semrush.com";"84.52.114.132" "1403186623";"us";"0";"domain_organic";"semrush.com";"84.52.114.132"
 
countapiunits
Price: Free

This report shows the current API balance for a given API key.

Endpoint

http://www.semrush.com/users/countapiunits.html

Request parameters

NameValueDescription
key*XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAn identification key assigned to a user after subscribing to SEMrush that is available via Profile page.

Request example

http://www.semrush.com/users/countapiunits.html?key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Response example

0
Have a Suggestion?