Retrieves a domain's 12-month advertising history from Semrush (keywords bid on, ad positions, ad copy) for PPC strategy and competitor analysis; most effective when the domain has ad history in the selected database.
domainRequiredstringWebsite name (e.g., 'example.com') to investigate.
databaseRequiredstringRegional database to use (e.g., 'us'). Link: https://developer.semrush.com/api/v3/analytics/basic-docs/#databases
display_sortstringSort order for results: `cv_asc` (Costs % ascending), `cv_desc` (Costs % descending).
display_limitintegerNumber of results for the current request (typically up to 100k). For larger datasets, use with `display_offset`. Cumulative `display_limit` with offset should not exceed 4,000,000.
export_escapeintegerIf 1, wraps report columns in double quotation marks ("); if 0, no escaping.
display_filterarrayFilters using column identifiers (e.g., `Ph`). Semrush's API may expect `+Column|Operator|Value` format (e.g., `+Ph|Ct|semrush`); consult Semrush documentation. Simplified filterable columns available: Ph (Keyword), Nq (Num. keywords), Cp (CPC), Tr (Traffic %).
display_offsetintegerNumber of initial results to skip for pagination. When fetching beyond 100k, `display_limit` might need to reflect `current_offset + desired_rows_for_this_page` per Semrush guidance.
export_columnsarrayData columns to include (e.g., `Ph`, `Dt`). If unspecified, all columns are returned. An empty list may error. Available: Ph (Keyword), Dt (Date), Po (Position), Cp (CPC), Nq (Num. keywords), Tr (Traffic %), Ur (URL), Tt (Ad Title), Ds (Ad Description), Vu (Volume), Cv (Costs %).
dataRequiredData from the action execution
errorstringError if any occurred during the execution of the action
successfulRequiredbooleanWhether or not the action execution was successful or not
API key connection. Risk level 2 of 5.
Free Action