Amazon Advertising • Analytics
get_search_term_performance
Search Term Performance
Get search term performance metrics with flexible sorting. Shows which customer search queries are driving sales or wasting spend. Essential for keyword harvesting and negative keyword discovery.
Use Cases
Find top converting search terms
Discover new keyword opportunities
Identify negative keyword candidates
Analyze customer search behavior
Example Prompts
Try these natural language queries with your AI assistant:
Show me top search terms by sales
Which search terms have the best ROAS?
Search terms with highest ACOS
What are customers searching for?
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| profile_id | string | Required | The profile ID (hash or number) |
| start_date | string | Required | Start date in YYYY-MM-DD format |
| end_date | string | Required | End date in YYYY-MM-DD format |
| sort_by | string | Optional | Metric to sort by: sales, spend, acos, roas, clicks, impressions, ctr, cpc, conversions, conversion_rate |
| order | string | Optional | Sort direction: asc, desc (default: desc) |
| limit | number | Optional | Number of results to return (default: 20) |
| min_spend | number | Optional | Minimum spend threshold to include |
| min_clicks | number | Optional | Minimum clicks threshold to include |
Returns
Response
Array of search terms with full performance metrics