Subfolder reports

Jump to Subfolder Overview (one database)Subfolder Overview (one database)

Price: 10 API units per line

Price for historical data: 50 API units per line

This report provides live or historical data on a subfolder’s keyword rankings in both organic and paid search in a chosen regional database.

About the Domain Overview report ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: subfolder_rank

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

subfolderRequired

Unique name of a website’s subfolder you’d like to investigate.

Value/Type: example.com/blog/

databaseRequired

Regional database (one value from the list).

For details, refer to Databases.

Value/Type: database

export_escape

If this parameter uses the value of 1, the report’s columns will be wrapped in double quotation marks (”).

Value/Type: 1

export_decode

If this parameter uses the value of 0, the response will be sent as a URL-encoded string; otherwise, the response will not be converted.

Value/Type: 1 or 0

display_date

Date for which a report will be shown. You can roll back to a date in the past or choose the current date.

Value/Type: date in format "YYYYMM15"

export_columns

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, the default columns will be sent: Rk, Or, Ot, Oc, Ad, At, Ac.

Note that Rk (Rank) returns 0 for URLs, subfolders, and subdomains. It only returns data for domains.

For details, refer to Columns.

Value/Type: Dn, Or, Xn, Ot, Oc, Ad, At, Ac, FKn, FPn, Ipu, Ip0, Ip1, Ip2, Ip3, Itu, It0, It1, It2, It3, Icu, Ic0, Ic1, Ic2, Ic3, Sr, Srb, St, Stb, Sc, Srn, Srl, Rk

Request example
https://api.semrush.com/?type=subfolder_rank&key=API_KEY&export_columns=Or,Ot,Oc,Ad,At,Ac&subfolder=tools.seobook.com/general/&database=us
Response exampleCSV
Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost
207;261;478;0;0;0

Jump to Subfolder Overview (history)Subfolder Overview (history)

Price: 10 API units per line

This report provides live and historical data on a subfolder’s keyword rankings in both organic and paid search in a chosen database.

About the Domain Overview report ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: subfolder_rank_history

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

subfolderRequired

Unique name of a website’s subfolder you’d like to investigate.

Value/Type: example.com/blog/

databaseRequired

Regional database (one value from the list).

For details, refer to Databases.

Value/Type: database

display_limit

The number of results returned to a request; if this parameter isn’t specified or equals 0, the default value will be 10,000 lines.

The maximum number of returned results is 100,000. If you need more results, use the display_offset parameter.

The maximum value for display_limit is 4,000,000.

Value/Type: integer

display_offset

This parameter allows you to skip a specified number of results before sending a report.

Remember that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

If you need more than the first 100,000 results, add the display_offset value to display_limit.

Keep in mind that the display_limit value must not exceed 4,000,000.

Value/Type: integer

export_escape

If this parameter is set to 1, the report’s columns will be wrapped in double quotation marks (”).

Value/Type: 1

Export_decode

If this parameter is set to 0, the response will be sent as a URL-encoded string; otherwise, the response won’t be converted.

Value/Type: 1 or 0

display_daily

This parameter allows you to get daily updates on position changes that occurred in the last 30 days or more. If the parameter isn’t specified, your report will show monthly results for the current and previous months.

Value/Type: 1

export_columns

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, the default columns will be sent: Rk, Or, Ot, Oc, Ad, At, Ac, Dt.

Note that Rk (Rank) returns 0 for URLs, subfolders, and subdomains. It only returns data for domains.

For details, refer to Columns.

Value/Type: Or, Xn, Ot, Oc, Ad, At, Ac, Dt, FKn, FPn, Sr, Srb, St, Stb, Sc, Rk

display_sort

This parameter lets you choose which column you would like to sort your results by, in ascending or descending order.

For details, refer to Sortings.

Value/Type: dt_asc, dt_desc

Request example
https://api.semrush.com/?type=subfolder_rank_history&key=API_KEY&display_limit=10&export_columns=Or,Ot,Oc,Ad,At,Ac,Dt&subfolder=tools.seobook.com/general/&database=us
Response exampleCSV
Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost;Date
276;327;653;0;0;0;20230215
204;300;648;0;0;0;20230115
271;337;946;0;0;0;20221215
220;324;874;0;0;0;20221115
206;313;954;0;0;0;20221015
189;301;940;0;0;0;20220915
161;302;972;0;0;0;20220815
223;427;1157;0;0;0;20220715
201;346;771;0;0;0;20220615
220;302;806;0;0;0;20220515

Jump to Subfolder Overview (all databases)Subfolder Overview (all databases)

Price: 10 API units per line

Price for historical data: 50 API units per line

This report provides live or historical data on a subfolder’s keyword rankings in both organic and paid search in all regional databases.

About the Domain Overview report ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: subfolder_ranks

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

subfolderRequired

Unique name of a website’s subfolder you’d like to investigate.

Value/Type: example.com/blog/

database

Regional database. If this parameter isn’t specified, your request will be sent to all regional databases.

For details, refer to Databases.

Value/Type: database

display_limit

The number of results returned to a request; if this parameter isn’t specified or equals 0, the default value will be 10,000 lines.

The maximum number of returned results is 100,000. If you need more results, use the display_offset parameter.

The maximum value for display_limit is 4,000,000.

Value/Type: integer

display_offset

This parameter allows you to skip a specified number of results before sending a report.

Remember that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

If you need more than the first 100,000 results, add the display_offset value to display_limit.

Keep in mind that the display_limit value must not exceed 4,000,000.

Value/Type: integer

export_escape

If this parameter is set to 1, the report’s columns will be wrapped in double quotation marks (”).

Value/Type: 1

display_date

Date for which the report will be shown. You can roll back to a date in the past or choose the current date.

Value/Type: date in format "YYYYMM15"

export_columns

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, the default columns will be sent: Db, Rk, Or, Ot, Oc, Ad, At, Ac, Sh, Sv.

Note that Rk (Rank) returns 0 for URLs, subfolders, and subdomains. It only returns data for domains.

For details, refer to Columns.

Value/Type: Db, Dt, Dn, Or, Ot, Oc, Ad, At, Ac, Sh, Sv, FKn, FPn, Sr, Srb, St, Stb, Sc, Srn, Srl, Rk

display_sort

This parameter lets you choose which column you would like to sort your results by, in ascending or descending order.

For details, refer to Sortings.

Value/Type: or_asc, or_desc, ot_asc, ot_desc, oc_asc, oc_desc, ad_asc, ad_desc, at_asc, at_desc, ac_asc, ac_desc

Request example
https://api.semrush.com/?key=API_KEY&type=subfolder_ranks&export_columns=Db,Or,Ot,Oc,Ad,At,Ac,Sh,Sv&subfolder=tools.seobook.com/general/&database=us
Response exampleCSV
Database;Organic Keywords;Organic Traffic;Organic Cost;Adwords Keywords;Adwords Traffic;Adwords Cost;PLA keywords;PLA uniques
us;207;261;478;0;0;0;0;0

Jump to Subfolder Organic Search KeywordsSubfolder Organic Search Keywords

Price: 10 API units per line

Price for historical data: 50 API units per line

This report lists keywords that bring users to a subfolder via Google’s top 100 organic search results.

About the Organic Research Overview report ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: subfolder_organic

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

subfolderRequired

Unique name of a website’s subfolder you’d like to investigate.

Value/Type: example.com/blog/

databaseRequired

Regional database (one value from the list).

For details, refer to Databases.

Value/Type: database

display_limit

The number of results returned to a request; if this parameter isn’t specified or equals 0, the default value will be 10,000 lines.

The maximum number of returned results is 100,000. If you need more results, use the display_offset parameter.

The maximum value for display_limit is 4,000,000.

Value/Type: integer

display_offset

This parameter allows you to skip a specified number of results before sending a report.

Remember that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

If you need more than the first 100,000 results, add the display_offset value to display_limit.

Keep in mind that the display_limit value must not exceed 4,000,000.

Value/Type: integer

export_escape

If this parameter is set to 1, the report’s columns will be wrapped in double quotation marks (”).

Value/Type: 1

display_date

The date for which the report will be shown. You can roll back to a date in the past or choose the current date.

Value/Type: date in format "YYYYMM15"

display_daily

This parameter allows you to get daily updates on position changes that occurred in the last 30 days or more. If the parameter isn’t specified, your report will show monthly results for the current and previous months. This option is applied only when display_positions is set.

Value/Type: 1

export_columns

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, the default columns will be sent: Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tc, Co, Nr, Td.

For details, refer to Columns.

Value/Type: Ph, Po, Pp, Pd, Nq, Cp, Ur, Tr, Tg, Tc, Co, Nr, Td, Kd, Fp, Fk, Ts, In, Pt

display_sort

This parameter lets you choose which column you would like to sort your results by, in ascending or descending order.

For details, refer to Sortings.

Value/Type: po_asc, po_desc, tg_asc, tg_desc, tr_asc, tr_desc, tc_asc, tc_desc, nq_asc, nq_desc, co_asc, co_desc, kd_asc, kd_desc, cp_asc, cp_desc, nr_asc, nr_desc, ts_asc, ts_desc

display_positions

The new value indicates keywords that brought a subfolder to Google’s top 100 organic or paid search results;
lost indicates keywords that no longer bring a subfolder to Google’s top 100 organic or paid search results;
rise indicates keywords that helped a subfolder get a higher ranking in Google’s top 100 organic or paid search results;
fall indicates keywords that are currently helping a subfolder remain in the Google top 100, though its ranking may have decreased.

Value/Type: new, lost, rise or fall

display_filter

Filters for columns.

For details, refer to Filters.

Value/Type: Ph, Po, Nq, Cp, Ur, Tg, Tr, Tc, Nr, Co, Pp, Pd, Fp, Fk, In, Br

display_positions_type

The organic value indicates keywords for which the subfolder ranks only in the traditional positions on the SERP. This is the default value.

all indicates keywords for which the subfolder ranks for traditional positions and the keywords where the subfolder ranks in SERP Features.

serp_features indicates keywords for which the subfolder ranks only in SERP Features.

Value/Type: organic, all, serp_features

Request example
https://api.semrush.com/?type=subfolder_organic&key=API_KEY&display_filter=%2B%7CPh%7CCo%7Cseo&display_limit=10&export_columns=Ph,Po,Pp,Pd,Nq,Cp,Ur,Tr,Tc,Co,Nr,Td&subfolder=tools.seobook.com/general/&display_sort=tr_desc&database=us
Response exampleCSV
Keyword;Position;Previous Position;Position Difference;Search Volume;CPC;Url;Traffic (%);Traffic Cost (%);Competition;Number of Results;Trends
seo keyword density checker;4;4;0;20;2.03;http://tools.seobook.com/general/keyword-density/;0.38;0.41;0.24;2000000;0.14,0.09,0.09,0.09,0.09,0.09,0.09,0.09,0.09,0.09,0.09,0.09
seo keyword density;10;10;0;90;3.45;http://tools.seobook.com/general/keyword-density/;0.38;1.25;0.01;2330000;0.52,0.33,0.52,0.42,0.23,0.66,0.52,0.42,0.33,0.42,1.00,0.33
seo analiser;69;69;0;110;4.61;http://tools.seobook.com/general/keyword-density/;0.00;0.00;0.17;10700000;0.07,0.28,0.28,0.05,0.05,0.05,0.28,0.66,0.17,1.00,0.35,0.66
seo spyder;74;74;0;70;3.57;http://tools.seobook.com/general/spider-test/;0.00;0.00;0.03;2230000;0.17,0.05,0.64,0.64,0.11,1.00,0.11,1.00,0.11,0.00,0.17,0.52
seo analysier;79;79;0;30;4.84;http://tools.seobook.com/general/keyword-density/;0.00;0.00;0.17;8550000;0.00,0.00,0.03,0.07,0.00,0.00,0.00,0.00,1.00,0.26,0.00,0.00
reciprocal links seo;42;42;0;40;0.00;http://tools.seobook.com/general/link-check/;0.00;0.00;0.02;1920000;0.34,0.26,0.19,0.03,0.00,0.00,0.03,0.00,0.07,0.19,0.26,0.34
test seo;76;76;0;260;3.63;http://tools.seobook.com/general/spider-test/;0.00;0.00;0.06;221000000;0.43,0.66,0.82,0.82,0.66,0.82,0.82,0.82,0.23,0.28,0.53,0.43
spider seo;52;52;0;90;3.57;http://tools.seobook.com/general/spider-test/;0.00;0.00;0.03;12100000;0.41,0.17,1.00,0.82,0.29,0.29,0.29,0.29,0.41,0.29,0.52,1.00
reciprocal linking seo;46;46;0;50;0.00;http://tools.seobook.com/general/link-check/;0.00;0.00;0.01;2270000;1.00,0.18,0.18,0.18,0.18,0.18,0.18,0.18,0.18,1.00,1.00,1.00
analyser seo;44;44;0;50;3.90;http://tools.seobook.com/general/keyword-density/;0.00;0.00;0.01;3580000;0.00,0.03,0.06,0.34,0.06,0.06,0.00,0.00,0.00,0.34,1.00,0.21

Jump to Subfolder Paid Search KeywordsSubfolder Paid Search Keywords

Price: 20 API units per line

Price for historical data: 100 API units per line

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

About the Advertising Research Positions report ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: subfolder_adwords

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

subfolderRequired

Unique name of a website’s subfolder you’d like to investigate.

Value/Type: example.com/blog/

databaseRequired

Regional database (one value from the list).

For details, refer to Databases.

Value/Type: database

display_limit

The number of results returned to a request; if this parameter isn’t specified or equals 0, the default value will be 10,000 lines.

The maximum number of returned results is 100,000. If you need more results, use the display_offset parameter.

The maximum value for display_limit is 4,000,000.

Value/Type: integer

display_offset

This parameter allows you to skip a specified number of results before sending a report.

Remember that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

If you need more than the first 100,000 results, add the display_offset value to display_limit.

Keep in mind that the display_limit value must not exceed 4,000,000.

Value/Type: integer

export_escape

If this parameter is set to 1, the report’s columns will be wrapped in double quotation marks (”).

Value/Type: 1

export_decode

If this parameter is set to 0, the response will be sent as a URL-encoded string; otherwise, the response won’t be converted.

Value/Type: 1 or 0

display_date

Date for which the report will be shown. You can roll back to a date in the past or choose the current date.

Value/Type: date in format "YYYYMM15"

export_columns

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, the default columns will be sent: Ph, Po, Pp, Pd, Nq, Cp, Vu, Tr, Tc, Co, Nr, Td.

For details, refer to Columns.

Value/Type: Ph, Po, Pp, Pd, Ab, Nq, Cp, Tg, Tr, Tc, Co, Nr, Td, Tt, Ds, Vu, Ur, Ts, Un

display_sort

This parameter lets you choose which column you would like to sort your results by, in ascending or descending order.

For details, refer to Sortings.

Value/Type: po_asc, po_desc, tg_asc, tg_desc, tr_asc, tr_desc, tc_asc, tc_desc, nq_asc, nq_desc

display_positions

The new value indicates keywords that brought a subfolder to Google’s top 100 organic or paid search results;
lost indicates keywords that no longer bring a subfolder to Google’s top 100 organic or paid search results;
rise indicates keywords that helped a subfolder get a higher ranking in Google’s top 100 organic or paid search results;
fall indicates keywords that are currently helping a subfolder remain in the Google top 100, though its ranking may have decreased.

Value/Type: new, lost, rise or fall

display_filter

Filters for columns.

For details, refer to Filters.

Value/Type: Ph, Po, Nq, Cp, Ur, Tg, Tr, Tc, Nr, Co, Pp, Pd, Un

Request example
https://api.semrush.com/?type=subfolder_adwords&key=API_KEY&display_limit=10&export_columns=Ph,Po,Pp,Pd,Nq,Cp,Ur,Tr,Tc,Co,Nr,Td&subfolder=ebay.com/help/&display_sort=po_asc&database=us
Response exampleCSV
Keyword;Position;Previous Position;Position Difference;Search Volume;CPC;Url;Traffic (%);Traffic Cost (%);Competition;Number of Results;Trends
ebayebay;1;1;0;2900;0.32;https://www.ebay.com/help/home;2.03;0.75;0.46;70;0.66,0.24,0.66,0.44,0.35,0.66,0.66,0.53,0.35,0.66,1.00,0.29
how to withdraw offer on ebay;1;0;-1;30;1.00;https://www.ebay.com/help/buying/buy-now/making-best-offer?id=4019;0.01;0.01;0.14;81;0.09,0.09,0.09,0.09,0.09,0.09,0.09,0.09,0.09,0.04,0.52,0.14
contact enay;1;1;0;70;1.85;https://www.ebay.com/help/-/contact-ebay/contact-ebay?id=4379;0.04;0.10;0.08;84;0.63,0.36,0.45,0.45,1.00,0.45,1.00,0.45,0.63,0.45,0.36,0.45
ebay how to cancel offer;1;1;0;90;1.00;https://www.ebay.com/help/buying/buy-now/making-best-offer?id=4019;0.05;0.06;0.14;55;0.64,0.52,0.64,0.64,0.52,0.64,0.64,0.52,0.41,0.52,0.64,0.64
myebaywatchlist;1;1;0;40;2.73;https://www.ebay.com/help/buying/search-tips/watchlist?id=4046;0.01;0.08;0.08;43;0.06,0.00,0.00,0.00,1.00,0.00,0.00,0.00,0.00,0.00,0.02,0.00
ebay cancel best offer;1;0;-1;90;1.00;https://www.ebay.com/help/buying/buy-now/making-best-offer?id=4019;0.05;0.06;0.14;73;0.82,0.82,1.00,1.00,0.82,0.29,0.23,0.29,0.17,0.29,0.52,0.23
block a buyer;1;1;0;90;0.80;https://www.ebay.com/help/selling/resolving-buyer-issues/blocking-buyer-ebay?id=4082;0.05;0.05;0.26;132000000;1.00,0.78,0.64,0.64,0.35,0.50,0.50,0.64,0.64,0.50,0.50,0.64
historical currency converter by year;1;1;0;70;0.00;https://www.ebay.com/help/buying/paying-items/paying-items?id=4009;0.04;0.00;0.03;61400000;0.66,0.42,0.52,0.42,0.33,0.19,0.33,0.33,0.14,0.09,0.23,0.09

Jump to Subfolder Organic PagesSubfolder Organic Pages

Price: 10 API units per line

Price for historical data: 50 API units per line

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

About the Organic Research Pages report ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: subfolder_organic_unique

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

subfolderRequired

Unique name of a website’s subfolder you’d like to investigate.

Value/Type: example.com/blog/

databaseRequired

Regional database (one value from the list).

For details, refer to Databases.

Value/Type: database

display_limit

The number of results returned to a request; if this parameter isn’t specified or equals 0, the default value will be 10,000 lines.

The maximum number of returned results is 100,000. If you need more results, use the display_offset parameter.

The maximum value for display_limit is 4,000,000.

Value/Type: integer

display_offset

This parameter allows you to skip a specified number of results before sending a report.

Remember that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

If you need more than the first 100,000 results, add the display_offset value to display_limit.

Keep in mind that the display_limit value must not exceed 4,000,000.

Value/Type: integer

export_escape

If this parameter is set to 1, the report’s columns will be wrapped in double quotation marks (”).

Value/Type: 1

export_decode

If this parameter is set to 0, the response will be sent as a URL-encoded string; otherwise, the response won’t be converted.

Value/Type: 1 or 0

display_date

Date for which the report will be shown. You can roll back to a date in the past or choose the current date. If you don’t set a date, the report is shown for the current date by default.

Value/Type: date in format "YYYYMM15"

export_columns

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, the default columns will be sent: Ur, Pc, Tg, Tr.

For details, refer to Columns.

Value/Type: Ur, Pc, Tg, Tr, Ipu, Ip0, Ip1, Ip2, Ip3, Itu, It0, It1, It2, It3, Sr, St

display_sort

This parameter lets you choose which column you would like to sort your results by, in ascending or descending order.

For details, refer to Sortings.

Value/Type: pc_asc, pc_desc, tg_asc, tg_desc, tr_asc, tr_desc, sr_asc, sr_desc, st_asc, st_desc

display_filter

Filters for columns.

For details, refer to Filters.

Value/Type: Ur, Pc, Tg, Tr, Ipu, Ip0, Ip1, Ip2, Ip3, Sr, St

Request example
https://api.semrush.com/?type=subfolder_organic_unique&key=API_KEY&display_filter=%2B%7CPc%7CGt%7C100&display_limit=5&export_columns=Ur,Pc,Tg,Tr&subfolder=ebay.com/help/&display_sort=tr_desc&database=us
Response exampleCSV
Url,Number of Keywords,Traffic,Traffic (%)
"https://www.ebay.com/help/buying/search-tips/purchase-history?id=4047","494","21074","19.45"
"https://www.ebay.com/help/account/signing-account/signing-account?id=4189","271","1786","1.64"
"https://www.ebay.com/help/account/default/ebay-account?id=4188","239","69789","64.43"
"https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822","233","161","0.14"
"https://www.ebay.com/help/buying/shipping-delivery/tracking-item?id=4027","232","672","0.62"

Jump to Ads CopiesAds Copies

Price: 40 API units per line

This report shows unique ad copies Semrush noticed when the subfolder ranked in Google’s paid search results for keywords from our databases.

About the Ads Copies report ›

Jump to EndpointEndpoint

GEThttps://api.semrush.com/

Request Parameters

typeRequired

Report type.

Value/Type: subfolder_adwords_unique

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

subfolderRequired

Unique name of a website’s subfolder you’d like to investigate.

Value/Type: example.com/blog/

databaseRequired

Regional database (one value from the list).

For details, refer to Databases.

Value/Type: database

display_limit

Number of results returned to a request; if this parameter isn’t specified or equals 0, the default value will be 10,000 lines.

The maximum number of returned results is 100,000. If you need more results, use the display_offset parameter.

The maximum value for display_limit is 4,000,000.

Value/Type: integer

display_offset

This parameter allows you to skip a specified number of results before sending a report.

Remember that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

If you need more than the first 100,000 results, add the display_offset value to display_limit.

Keep in mind that the display_limit value must not exceed 4,000,000.

Value/Type: integer

export_escape

If this parameter is set to 1, the report’s columns will be wrapped in double quotation marks (”).

Value/Type: 1

export_decode

If this parameter is set to 0, the response will be sent as a URL-encoded string; otherwise, the response won’t be converted.

Value/Type: 1 or 0

export_columns

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, the default columns will be sent: Tt, Ds, Vu, Ur, Pc, Un.

For details, refer to Columns.

Value/Type: Ph,Un,Tt,Ds,Vu,Ur,Pc,Ts

display_sort

This parameter lets you choose which column you would like to sort your results by, in ascending or descending order.

For details, refer to Sortings.

Value/Type: pc_asc, pc_desc

display_filter

Filters for columns.

For details, refer to Filters.

Value/Type: Tt, Ds, Vu

Request example
https://api.semrush.com/?type=subfolder_adwords_unique&key=API_KEY&display_limit=3&export_columns=Tt,Ds,Vu,Ur,Pc&subfolder=semrush.com/blog/&database=uk
Response exampleCSV
Title,Description,Visible Url,Url,Number of Keywords
"How to Analyze Competitor Website Traffic with Trends","Friendly interface, live data, millions of keywords to track. Get started!","https://www.semrush.com","https://www.semrush.com/blog/analyzing-competitors-traffic/","10"
"Best Keyword Research Tools: 10 Free & Paid Tools","Friendly interface, live data, millions of keywords to track. Get started!","https://www.semrush.com","https://www.semrush.com/blog/keyword-research-tools/","6"
"Google Ads Account to Create Relevant Ads | Semrush","Stay creative with your marketing campaigns & content. Semrush will take care of the data.","https://www.semrush.com","https://www.semrush.com/blog/google-ads-account/","5"

Last updated: January 30, 2026

Was this page helpful?