v1

List wasted-spend (blind spend) alerts

Returns a paginated list of blind-spend alerts across your connected Amazon seller accounts. A blind-spend alert flags ad spend on customer search terms that produced little or no sales; each alert embeds its unresolved wasted-spend search terms with spend/clicks/CVR. Results are scoped to your organization. Optionally filter by sellerId, marketplace, lifecycle status, and updatedSince (for incremental polling). Defaults to active alerts from the last 30 days. Rate limited to approximately 60 requests per minute per API key.

get/v1/alerts/blind-spend

Query parameters

sellerIdstring
Example:A1B2C3D4E5

Filter to a single Amazon seller account you have connected to DataDive

marketplace'com' | 'ca' | 'co.uk' | 'com.mx' | 'in' | 'fr' | 'de' | 'es' | 'it' | 'co.jp'
Example:com

Filter to a single Amazon marketplace code (e.g. com, co.uk, de, ca)

status'active' | 'resolved' | 'all'

Lifecycle filter. active (default) returns unresolved alerts, resolved returns resolved alerts, all returns both. Dismissed alerts are never returned.

updatedSincestring
Example:2024-06-01T00:00:00Z

Return only alerts surfaced at or after this ISO-8601 timestamp (filters on lastAlertedAt, i.e. when the alert was created). Use this to incrementally sync since your last poll. Defaults to the last 30 days when omitted.

currentPagenumber
Example:1

Page of items to retrieve (default 1)

pageSizenumber
Example:20

Items per page (default 20, max 50)

Response

currentPagenumber required
pageSizenumber required

Number of items per page

hasNextboolean required

True when there is a next page. Otherwise, false

hasPrevboolean required

True when there is a previous page. Otherwise, false

lastPagenumber required

Last page or total page count

totalnumber required

Total number of items

Example response

{
  "currentPage": 1,
  "pageSize": 20,
  "lastPage": 1,
  "total": 1,
  "data": [
    {
      "id": 12345,
      "sellerId": "A1B2C3D4E5",
      "marketplace": "com",
      "lastAlertedAt": "2024-06-01T12:00:00Z",
      "wastedSpend": 246.9,
      "totalKeywordCount": 8,
      "unresolvedKeywordCount": 5,
      "searchTerms": [
        {
          "term": "wireless earbuds bluetooth"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.