get_search_term_performance
Search terms with their clicks, spend and orders over a date range, on Amazon and Google Ads.
On this page
Endpoint
Search terms with their clicks, spend and orders over a date range, on Amazon and Google Ads.
The call shape is illustrative until the contract is final.
When to use it
Use it to find search terms that spend and never sell, or to keep search-term history past the window the platform holds. Amazon keeps search terms for about 60 to 95 days; Build keeps them from the day you connect.
Request fields
| Name | Type | Description |
|---|---|---|
| accountRequired | string | The account to read. A key only reaches the accounts you chose when you created it. |
| start | date | First day, as YYYY-MM-DD. |
| end | date | Last day, as YYYY-MM-DD. |
Response fields
Every answer says how fresh it is with data_as_of.
To write: the response fields of a search-term row (the term, match type, clicks, spend, orders, sales and any hidden-by-Google marker)
Examples
curl -X POST https://build-api.sellermate.ai/v1/tools/get_search_term_performance \
-H "X-API-Key: $BUILD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"account":"acct_123","start":"2026-10-01","end":"2026-10-28"}'To write: a real response with two or three rows
Errors
429 Too many requests
You went over the plan's requests per minute. The body says when to retry.
{ "error": "rate_limited", "retry": 12, "upgrade": "https://build.sellermate.ai/pricing" }
To write: the other errors this tool can return, with the real status and body: a missing or wrong key, an account the key cannot reach, bad dates
Platforms
Open in your AI
Paste this into Claude Code, Cursor, Lovable, n8n or Zapier. It points your AI at the docs and at your key.
Read https://build.sellermate.ai/SKILL.md. My key is in BUILD_API_KEY. Use get_search_term_performance to list search terms with 15 or more clicks and no orders in the last 30 days, costliest first.
Last updated 30 Oct 2026